开发者与集成

🔧 开发者友好：干净的 API、标准合规性和工具，实现无缝集成和开发

🔌 RESTful API 与标准合规

功能描述：干净的 REST API，完全兼容 MCP 协议 适用场景：与任何客户端轻松集成，保持 MCP 标准合规性 优势特点：文档完善的端点、标准 HTTP 方法、一致的响应

API 示例：

# MCP 协议端点
POST /mcp
Content-Type: application/json
Authorization: Bearer {token}

# OAuth 管理仪表板
GET /oauth

# OAuth 端点（启用身份验证时）
POST /oauth/token
GET /oauth/callback/:serverName

⏱️ 设置时间：立即可用 🎯 适用场景：自定义集成、API 客户端、第三方工具 ✅ 获得收益：标准 REST API、MCP 合规性、全面文档

---

📡 HTTP 传输与 MCP 协议

功能描述：使用 MCP 协议标准的基于 HTTP 的可靠通信 适用场景：AI 客户端和 MCP 服务器之间的标准合规通信 优势特点：请求/响应模式、适当的错误处理、协议合规性

HTTP MCP 示例：

# 基于 HTTP 的 MCP 协议
POST /mcp
Content-Type: application/json
Authorization: Bearer {token}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}

⏱️ 设置时间：内置，默认传输 🎯 适用场景：标准 MCP 客户端集成、可靠通信 ✅ 获得收益：MCP 协议合规性、可靠传输、标准 HTTP 方法

注意：SSE 传输已弃用 - 请改用 HTTP 传输

---

🧪 开发与集成支持

功能描述：提供用于测试和集成的开发者友好功能 适用场景：更轻松的开发、调试和集成测试 优势特点：热重载配置、结构化日志、MCP Inspector 支持

开发功能：

# 热重载配置更改
npx -y @1mcp/agent --config dev.json
# 编辑 dev.json → 自动应用更改

# 使用 MCP Inspector 进行测试
npx @modelcontextprotocol/inspector
# 连接到 http://localhost:3050 进行交互式测试

# 环境特定日志
ONE_MCP_LOG_LEVEL=debug npx -y @1mcp/agent --config dev.json

# 多环境配置
npx -y @1mcp/agent --config dev.json --port 3051
npx -y @1mcp/agent --config staging.json --port 3052

⏱️ 设置时间：内置开发功能 🎯 适用场景：开发工作流、测试、调试集成问题 ✅ 获得收益：热重载配置、MCP Inspector 集成、结构化日志、多环境支持

---

开发工作流

集成测试

• MCP Inspector：用于调试的交互式测试界面
• 健康端点：系统状态的自动化测试
• 请求/响应日志：详细的调试信息
• 多环境：开发/测试/生产的单独配置

API 集成

• 标准 REST：与任何 HTTP 客户端轻松集成
• 错误处理：一致的错误响应和代码
• 身份验证：用于安全 API 访问的 OAuth 2.1

调试和故障排除

• 结构化日志：基于 Winston 的分级日志
• 请求跟踪：跟踪通过系统的请求
• 健康诊断：详细的系统和服务器状态
• 配置验证：配置问题的早期检测

客户端库

• HTTP 客户端：使用任何 HTTP 库（fetch、axios、curl）
• MCP 库：官方 MCP 客户端库
• 实时通知：支持从服务器接收实时更新（例如，listChanged 通知）。
• 自定义集成：构建您自己的客户端实现

开发最佳实践

配置管理

• 环境分离：每个环境的不同配置
• 密钥管理：安全处理敏感数据
• 热重载：快速开发迭代周期
• 验证：配置错误的早期检测

测试策略

• 单元测试：测试单个组件和函数
• 集成测试：测试服务器交互和工作流
• 端到端测试：使用真实 MCP 服务器的完整系统测试
• 负载测试：现实条件下的性能测试

监控和可观测性

• 请求日志：跟踪所有 API 请求和响应
• 性能指标：监控响应时间和吞吐量
• 错误跟踪：集中错误收集和分析
• 健康监控：持续系统健康验证

下一步

• 核心设置 → 核心功能
• 安全集成 → 安全功能
• 生产部署 → 企业功能

集成指南

• 身份验证设置 → 身份验证指南
• 配置参考 → 配置指南
• API 文档 → API 参考

---

🔧 开发者提示：这些功能旨在使集成和开发尽可能顺畅。从 MCP Inspector 的交互式测试开始，然后使用标准 HTTP API 构建您的集成。