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代码
安装```bash
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)```bash
# 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用户界面```bash
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快速启动```bash
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` (不要承诺)
## 发展```bash
# stop services
kill $(cat gunicorn.pid) 2>/dev/null || true
pkill -x ollama 2>/dev/null || true
# logs
tail -n 120 server.log | cat
包装(可选)```bash
pip install pyinstaller
pyinstaller --onefile --name mcp-local-server --hidden-import flask_cors main.py
```
许可证
麻省理工学院
