使用说明
MCP代码助手（主机本机）
一个主机原生MCP服务器，直接在您的计算机上运行，并提供安全、结构化的工具，用于与您的代码库和开发环境进行交互。
关键架构
此服务器运行 直接在主机上（Codex风格）:
- 完全访问主机文件系统（工作区范围）
- 访问主机进程(
ps) - 访问主机网络(
ss,netstat) - 使用主机安装的二进制文件（git、rg、pytest等）
- 可通过主机CLI访问Docker
有 无集装箱边界.安全是在规范中执行的。
需求
在主机上安装以下内容：
- Python 3.11+
- ripgrep(
rg) - ast grep
- 版本控制系统
- 可选：Docker（用于Docker工具）
所需的系统实用程序：
- PS
- ss或netstat
- 数据帧
- 尾巴
示例（macOS）：
brew install ripgrep ast-grep
运行服务器
选项1--辅助脚本
bash scripts/run_local.sh
选项2——直接
uvicorn app.main:app --host 127.0.0.1 --port 8000
服务器：
http://localhost:8000
MCP端点：
http://localhost:8000/mcp
安全模型
由于这是在您的主机上运行的，因此安全性是通过以下方式强制执行的：
- 命令分配列表(
run_command) - 参数验证（无shell注入）
shell=False到处- 工作空间路径限制
- 输出截断
- 超时
- 秘密编辑（环境检查）
您有责任信任使用此服务器的客户端。
Docker工具（可选）
Docker工具仍然可用，但假设：
- Docker CLI已安装在主机上
- Docker守护进程正在运行
不使用集装箱安装或码头。使用袜子技巧。
示例工具
- list_dir
- read_file
- ripgrep_sesearch
- ast_grep_search
- 运行命令
- docker_exec_*
- host_ps/host_ports/host_env
备注
- 缺少二进制文件将返回有用的错误
- 返回代码127表示缺少命令
- 更喜欢
write_file用于编辑的过度修补工具
传统Docker模式（可选）
如果你愿意，你仍然可以在Docker中运行它，但它不再是主要或推荐的模式。
