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 | catGradio用户界面
# 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许可证
麻省理工学院