mcplocal (Countermine2992)

MCP本地AI服务器（macOS）+Gradio UI

一个本地模型上下文协议（MCP）服务器，连接到Ollama托管的LLM和您的macOS机器，以执行安全的文件系统操作、自动化、VSCode和Git任务。包括一个Gradio UI，用于启动/停止服务和聊天。

特性

• 文件系统工具：read_file、write_file、list_files（路径保护）
• macOS自动化：AppleScript、通知、应用程序控制
• VSCode集成：打开文件、创建项目、安装扩展
• Git操作：初始化、添加、提交、状态、克隆
• 学习系统：跟踪成功的任务工作流程以获取建议
• Gradio UI：启动/停止全部、健康/状态、聊天、直接MCP工具

需求

• macOS 10.15+
• Python 3.9+
• Ollama已安装，并且至少有一个模型（例如。， qwen2.5:0.5b)
• （可选）Visual Studio代码

安装

# Clone your repo
git clone 
cd mcp-local-ai-server

# Python env
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

启动服务（CLI）

# Start server (gunicorn)
gunicorn -w 2 -t 180 -b 127.0.0.1:5001 main:app > server.log 2>&1 & echo $! > gunicorn.pid

# Ensure Ollama is running
pgrep -x ollama >/dev/null || (ollama serve >/dev/null 2>&1 &)

# Health check
curl -s http://127.0.0.1:5001/api/mcp/health | cat

Gradio用户界面

# launch on 127.0.0.1:7861
export GRADIO_SERVER_PORT=7861
python ui.py

打开 http://127.0.0.1:7861 以及：

• 设置模型（例如。， qwen2.5:0.5b)和允许的路径
• 单击“全部开始”
• 使用状态/健康、列表目录（直接MCP）和聊天

环境变量

• FLASK_SECRET_KEY：Flask密钥（推荐）
• ALLOWED_PATHS：以逗号分隔的文件系统工具可以访问的目录列表。例子：

  export ALLOWED_PATHS="/Volumes/externalmac,$HOME,$PWD"

• GRADIO_SERVER_PORT：Gradio UI端口（默认7860）

API快速启动

# list tools
curl -s http://127.0.0.1:5001/api/mcp/tools | jq .

# list files in a directory (must be in ALLOWED_PATHS)
curl -s -X POST http://127.0.0.1:5001/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":"1","method":"tools/call",
    "params":{"name":"list_files","arguments":{"path":"/Volumes/externalmac"}}
  }' | jq .

# chat
curl -s -X POST http://127.0.0.1:5001/api/chat/start \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"Say hello and list available tools","enable_learning":true}' | jq .

安全

• 文件系统访问权限仅限于 ALLOWED_PATHS （白名单）
• 应审查潜在的破坏性行为
• 日志被写入 server.log （不要承诺）

发展

# stop services
kill $(cat gunicorn.pid) 2>/dev/null || true
pkill -x ollama 2>/dev/null || true

# logs
tail -n 120 server.log | cat

包装（可选）

pip install pyinstaller
pyinstaller --onefile --name mcp-local-server --hidden-import flask_cors main.py

许可证

麻省理工学院