MCP 服务器文档

简介

MCP（Mission Control Protocol，任务控制协议）服务器是一个用于与Dust.tt API交互的工具，允许通过代理Claude模型进行对话。本文档详细介绍了如何配置和使用该服务器。

安装指南

快速安装

1. 克隆代码仓库：

git clone git@github.com:your-repository.git

2. 安装依赖项：

pip install -r requirements.txt

配置

创建一个配置文件config.json，内容如下：

{
  "workspace_id": "{WORKSPACE_ID}", // 替换为你的工作区ID
  "api_key": "{YOUR_API_KEY}",     // 替换为你的API密钥
  "agent_id": "{AGENT_ID}",        // 替换为你的代理ID
  "model_settings": {
    "provider": "anthropic",
    "model": "claude-3-sonnet"
  }
}

启动服务器

运行以下命令启动MCP服务器：

python mcp_server.py --config config.json

API 接口

创建对话

发送 POST 请求以创建新对话：

curl -X POST "http://localhost:8000/api/conversations" \
  -H "Content-Type: application/json" \
  -d '{"title": "系统思维对话", "model": "claude-3-5-sonnet-20240620"}'

响应示例：

{
  "conversation": {
    "sId": "DhvpbhW74S",
    "title": "系统思维对话",
    "created_at": 1742923287427
  }
}

发送消息

向指定对话发送用户消息：

curl -X POST "http://localhost:8000/api/conversations/{CONVERSATION_ID}/messages" \
  -H "Content-Type: application/json" \
  -d '{"content": "解释MCP协议的细节", "mentions": [{"configurationId": "{AGENT_ID}", "context": {"时区": "Europe/Berlin", "modelSettings": {"provider": "anthropic"}}]}, "context": {"时区": "Europe/Berlin"}}'

响应示例：

{
  "message": {
    "sId": "qwenj3rusI",
    "conversation_sId": "DhvpbhW74S",
    "content": "解释MCP协议的细节",
    "author_name": "用户",
    "author_type": "user",
    "created_at": 1742923287627
  }
}

检索消息

从指定对话中检索消息：

curl -X GET "http://localhost:8000/api/conversations/{CONVERSATION_ID}/messages" \
  -H "Content-Type: application/json"

响应示例：

[
  {"message_id": "qwenj3rusI", "content": "解释MCP协议的细节", "timestamp": 1742923287627},
  {"message_id": "another-id", "content": "回复内容", "timestamp": 1742923287630}
]

错误处理

常见错误

• 400 Bad Request: 请求格式无效。
• 401 Unauthorized: 认证失败。
• 404 Not Found: 对话或消息不存在。

日志记录

MCP服务器支持日志记录功能，日志文件默认存储在logs/目录下，格式为YYYYMMDD.log。

示例

以下是一个完整的对话流程示例：

1. 创建对话：

curl -X POST "http://localhost:8000/api/conversations" \
  -H "Content-Type: application/json" \
  -d '{"title": "测试对话", "model": "claude-3-5-sonnet-20240620"}'

响应：

{"conversation": {"sId": "test-id", "title": "测试对话", "created_at": 1742923287427}}

2. 发送消息：

curl -X POST "http://localhost:8000/api/conversations/test-id/messages" \
  -H "Content-Type: application/json" \
  -d '{"content": "你好！我是测试用户。", "mentions": [{"configurationId": "{AGENT_ID}", "context": {"时区": "Europe/Berlin", "modelSettings": {"provider": "anthropic"}}]}, "context": {"时区": "Europe/Berlin"}}'

响应：

{"message": {"sId": "msg-id-123", "content": "你好！我是测试用户。", "timestamp": 1742923287627}}

3. 检索消息：

curl -X GET "http://localhost:8000/api/conversations/test-id/messages" \
  -H "Content-Type: application/json"

响应：

[
  {"message_id": "msg-id-123", "content": "你好！我是测试用户。", "timestamp": 1742923287627},
  {"message_id": "msg-id-456", "content": "您好！我是代理模型。", "timestamp": 1742923287630}
]

项目贡献

我们欢迎社区贡献代码和文档改进。请在GitHub仓库中提交拉取请求。

联系方式

如有任何问题或反馈，请联系：

• 邮箱：contact@your-domain.com
• GitHub：github.com/your-repository