ade MCP

ADE-MCP：模型上下文协议工具包

 

适用于在Claude Code和Claude Desktop等AI开发环境中构建、部署和管理MCP（模型上下文协议）服务器的生产就绪工具包。

特点/特性

🔐（锁形符号，常用于表示安全、保密或需要解锁/密码的内容） 安全API密钥管理

• 使用Fernet + PBKDF2HMAC（480,000次迭代）进行加密存储
• 文件权限设置为0600（仅所有者可访问）
• CLI 输出中的密钥被遮蔽
• 使用提供商API测试密钥

🏥 诊所/医院 健康监测

• 服务器健康检查
• 可配置间隔的持续监控
• 所有已配置服务器的状态报告
• 连接验证

⚙️ 表示齿轮或机械装置的符号，常用于表示机械、技术或工业相关的内容。 配置管理

• 验证MCP配置文件（JSON/YAML）
• 合并多个配置
• 以格式化表格显示配置
• 模式验证

🎨 表示“美术”或“绘画”的意思，通常用作表情符号或符号来代表与艺术、绘画相关的主题。 模板生成器

• 使用Python或TypeScript构建MCP服务器框架
• 几秒内完成整个项目结构
• 内置最佳实践
• 即开即用的示例

快速入门

安装

pip install ade-mcp

基本用法

# Validate MCP configuration
ade-mcp config validate mcp_config.json

# Add and test API key
ade-mcp keys add brave-search --provider brave --api-key BSA_xxxxx
ade-mcp keys test brave-search

# Check server health
ade-mcp health check
ade-mcp health monitor --interval 30

# Generate new MCP server
ade-mcp template create my-server --type python

命令

配置管理

# Validate configuration file
ade-mcp config validate 

# Show configuration in table format
ade-mcp config show 

# Merge multiple configurations
ade-mcp config merge config1.json config2.json -o merged.json

API密钥管理

# Add new API key
ade-mcp keys add  --provider 
 --api-key 

# List all keys (masked)
ade-mcp keys list

# Test a key
ade-mcp keys test 

# Delete a key
ade-mcp keys delete 

支持的提供商：

• 勇敢搜索（或译为“无畏搜索”，根据语境可灵活调整）
• 谷歌自定义搜索
• Tavily（注：此词可能为特定品牌或项目名，无直接对应中文翻译，故保留原样）
• OpenAI（开放人工智能研究所）
• “Anthropic”可以翻译为“人类中心论的”或“以人类为中心的”，具体翻译取决于上下文和使用场景。在人工智能或哲学领域，这个词可能用来描述以人类为中心的设计、思考或研究方法

健康监测

# Check all configured servers
ade-mcp health check

# Check specific server
ade-mcp health check 

# Continuous monitoring
ade-mcp health monitor --interval 30

模板生成

# Create Python MCP server
ade-mcp template create my-server --type python

# Create TypeScript MCP server
ade-mcp template create my-server --type typescript

# Navigate and use
cd my-server
uv sync
uv run my_server

示例：Brave Search MCP 服务器

位于 examples/brave-search-server/：

cd examples/brave-search-server
uv sync
export BRAVE_API_KEY=your_key_here
uv run brave-search-mcp

特点：

• 带分页功能的网页搜索
• 新闻搜索
• 本地搜索
• 搜索建议
• 可配置的结果数量

配置文件格式

JSON 示例

{
  "mcpServers": {
    "brave-search": {
      "command": "python",
      "args": ["-m", "brave_search_server"],
      "env": {
        "BRAVE_API_KEY": "BSA_xxxxx"
      }
    }
  }
}

YAML 示例

mcpServers:
  brave-search:
    command: python
    args:
      - "-m"
      - "brave_search_server"
    env:
      BRAVE_API_KEY: BSA_xxxxx

安全

API密钥加密

密钥使用以下方法进行加密：

• 算法Fernet（对称加密）
• 密钥派生使用SHA-256的PBKDF2HMAC
• 迭代48万
• 盐每个密钥使用随机16字节的盐值

存储

• 存储的密钥位于 ~/.ade-tools/keys.enc
• 文件权限： 0600 （仅所有者可读/写）
• 从系统熵派生出的主密码

最佳实践

1. 不要将API密钥提交到版本控制系统中
2. 在CI/CD中使用环境变量来存储密钥
3. 定期更换密码
4. 旋转后测试键
5. 在提供商仪表板中监控密钥使用情况

建筑

包装结构

ade_mcp/
├── config.py       # Configuration management
├── health.py       # Health monitoring
├── keys.py         # API key management
├── main.py         # CLI entry point
├── template.py     # Template generation
└── lib/            # Core libraries
    ├── config.py
    ├── crypto.py
    ├── health.py
    ├── keymanager.py
    ├── models.py
    ├── providers.py
    └── template.py

数据模型

• MCP配置完整的MCP配置结构
• MCPServerConfig 翻译为中文是“MCPServer配置”单个服务器配置
• API密钥加密的API密钥存储
• 健康状态服务器健康检查结果

发展

# Clone repository
git clone https://github.com/phdsystems/ade-mcp.git
cd ade-mcp

# Install in development mode
pip install -e ".[dev]"

# Run tests
pytest tests/ -v

# Run with coverage
pytest tests/ --cov=ade_mcp --cov-report=html

要求

• Python 3.10及以上版本
• 点击次数 >= 8.1.0
• rich 版本 >= 13.0.0
• pydantic 版本 >= 2.0.0
• pyyaml >= 6.0.0
• 密码学库版本 >= 41.0.0
• httpx 版本 >= 0.25.0
• python-dotenv >= 1.0.0
• Jinja2 >= 3.1.0

用例

1. Claude桌面集成

为Claude Desktop配置MCP服务器：

# Validate your config
ade-mcp config validate ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Add API keys securely
ade-mcp keys add brave-api --provider brave --api-key BSA_xxxxx

# Check server health
ade-mcp health check

2. CI/CD流水线

# .github/workflows/test.yml
- name: Validate MCP Config
  run: ade-mcp config validate config/mcp.json

- name: Test API Keys
  run: |
    ade-mcp keys add test-key --provider brave --api-key ${{ secrets.BRAVE_KEY }}
    ade-mcp keys test test-key

3. 服务器开发

# Generate new server
ade-mcp template create weather-server --type python

# Develop and test
cd weather-server
uv sync
uv run weather-server

# Health check during development
ade-mcp health monitor --interval 10

支持的MCP版本

• MCP规范：最新版
• Python SDK：0.1.0及以上版本
• TypeScript SDK：0.1.0及以上版本

链接

• 文档: 文档/
• 示例： 示例/例子
• MCP规范https://spec.modelcontextprotocol.io/（可译为）：模型上下文协议规范网站
• GitHubhttps://github.com/phdsystems/ade-mcp 翻译为中文是：“https://github.com/phdsystems/ade-mcp（GitHub仓库地址，包含Ade-Mcp项目）”。不过，通常在中文语境下，我们不会直接翻译网址，而是说明其内容或用途，比如：“这是GitHub上的一个项目链接，名为Ade-Mcp，由phdsystems维护。” 但在这里，为了保持原句的结构，我给出了网址的直译
• 问题https://github.com/phdsystems/ade-mcp/issues（中文可表述为：“GitHub上的phdsystems/ade-mcp项目的问题追踪页面”）

许可证

MIT 许可证 - 详见 许可证 文件中详述。

相关项目

• ade-search（可译为“ADE搜索”或根据具体上下文调整为更贴切的表述）带有智能错误处理的智能CLI搜索工具
• ADE 工具完整的AI开发环境工具包

做出贡献

欢迎投稿！请参阅 CONTRIBUTING.md 翻译为中文是：“贡献指南.md” 或 “如何贡献.md”（具体翻译可能根据上下文略有调整，但基本意思相同）。这个文件名通常用于指示如何向某个项目或组织做出贡献的指南文档 作为指南。

支持

• 问题https://github.com/phdsystems/ade-mcp/issues（可翻译为）：“https://github.com/phdsystems/ade-mcp 项目中的问题（或‘议题’）页面”
• 讨论https://github.com/phdsystems/ade-mcp/discussions 翻译为中文是：“https://github.com/phdsystems/ade-mcp/讨论板块” 或 “https://github.com/phdsystems/ade-mcp/讨论区”
• 文档https://github.com/phdsystems/ade-mcp/tree/master/doc 翻译为中文是：“https://github.com/phdsystems/ade-mcp 项目的 master 分支下的 doc 目录”

______________________________________________________________________

由PHD Systems倾心打造