VS Code Copilot桥接服务器

公司mcp服务器

Python MCP服务器（端口 8012)将VS Code Copilot代理连接到 [公司](https://github.com/the服务器）网关生态系统。 伴侣 机构与代理公司.

工具（138）

快速开始

python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env   # fill in tokens
bash scripts/start.sh

添加到VS代码 settings.json:

"mcp.servers": {
  "firm-extensions": { "url": "http://127.0.0.1:8012/mcp" }
}

脚本

bash scripts/start.sh    # start in background
bash scripts/stop.sh     # graceful stop
bash scripts/status.sh   # PID + HTTP + tool count

测试

pip install -r requirements-dev.txt
python -m pytest tests/test_smoke.py -v

2272次测试 （1961单元+311集成）， 94.6%的覆盖率，包括：

• 服务器启动并应答 ping
• initialize 返回正确的功能+ __version__
• 已注册的所有115个工具均有效 inputSchema
• vs_context_push 在没有网关的情况下优雅降级
• firm_export_document 写入本地文件
• 未知方法返回JSON-RPC错误-32601
• 未知工具返回描述性错误
• 定时安全认证（I21）、SQL注入保护（I24）、session_id正则表达式（I41）
• 跨所有21个配置路径模型的ConfigPathInput遍历阻塞（I27）
• Health/healthz端点返回正确的工具计数+版本（I35）
• 共享 config_helpers: load_config, get_nested, mask_secret （I25）
• Hebbian内存：收获PII剥离、权重更新模拟运行、层验证、漂移检测、Pydantic遍历保护

安全

• 认证：定时安全 hmac.compare_digest 承载令牌上——无定时侧信道（I21）
• 请求限制: client_max_size=2MB 是打算 Application （I22）
• 刀具超时: asyncio.wait_for 随着 TOOL_TIMEOUT_S （默认120秒）用于所有异步工具调用（I23）
• SQL注入保护: table_name 通过Pydantic正则表达式验证 ^[a-zA-Z_][a-zA-Z0-9_]{0,127}$ +处理程序中的运行时白名单（I24）
• 会话ID正则表达式: ^[a-zA-Z0-9_\-:.]+$ 在所有 session_id 字段——无注射（I41）
• 集中式版本: __version__ 在 main.py --单一真理来源（I37）
• 干燥助手: config_helpers.py --共享 load_config, get_nested, mask_secret （I25）
• ConfigPathInput库：21个模型从单个基类（I27）继承遍历保护
• Hebbian PII剥离：在任何会话存储之前应用的9个regex模式（电子邮件、电话、IP、API密钥、SSN、JWT、AWS密钥）-CDC§5.2
• Hebbian漂移检测：TF-IDF余弦相似性与基线（无外部API）-CDC§5.1
• Hebbian重量帽：自动更新上限为0.95，萎缩下限为0.0，dry_run=True默认值--CDC§4.3
• GitHub PR始终创建为 草稿 随着 needs-review 标签
• 通过以下方式在日志中屏蔽令牌（仅限最后4个字符） mask_secret()
• 每个WS有效负载的上下文上限为32KB
• fleet.json 和 acp_sessions.json 原子书写(os.replace)
• 通过以下方式锁定工作区 fcntl.LOCK_EX | LOCK_NB （咨询，碰撞安全）
• fleet_session_inject_env：allowlist正则表达式--只接受已知的提供程序密钥
• fleet_cron_schedule：命令allowlist正则表达式+块列表(rm, dd, mkfs…)
• 路径遍历防护(..)在所有文件路径Pydantic字段上
• 所有AI输出都带有人工审查免责声明

缺口覆盖率（公司审计）

⚠️ 人工智能生成的内容-使用前需要人工验证。