使用说明
MCP AI代理服务器
一个MCP服务器，将Cline连接到AI代理系统，允许通过模型上下文协议与AI代理进行无缝交互。
特性
- 🚀 发送消息： 在会话中向AI代理发送消息。
- 💡 会话管理： 清除会话并开始新的会话。
- 🔧 管理助理： 获取可用助手的列表，并更改会话的助手。
快速开始
通过npm安装（推荐）
npm install -g @avi/mcp-ai-agent-server
通过npx安装（无需安装）
npx @avi/mcp-ai-agent-server
配置
对于克莱恩
添加到您的Cline MCP设置文件中：
地点：
- macOS：
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json - 窗户：
%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json - Linux：
~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
配置：
{
"mcpServers": {
"ai-agent-mcp": {
"command": "npx",
"args": ["@avi/mcp-ai-agent-server"],
"env": {
"AI_AGENT_API_KEY": "your-api-key-here",
"AI_AGENT_BASE_URL": "http://localhost:3000"
}
}
}
}
可用工具
send_message
在会话中发送带有可选附件的消息。
参数：
messageContent（必填）：要发送的消息内容。attachments（可选）：文件附件数组。
例子：
"Can you use send_message to say 'hello'?"
get_session
获取或创建会话。
参数：
- 无
例子：
"Get the current session."
clear_session
清除当前会话并开始新会话。
参数：
- 无
例子：
"Please clear the session."
get_assistants
获取可用助手的列表。
参数：
- 无
例子：
"List the available assistants."
change_assistant
更换会话助理。
参数：
sessionId（必填）：要更新的会话ID。newAssistantId（必填）：新助理的ID。
例子：
"Change the assistant for the current session to 'assistant-2'."
环境变量
| 变量 | 描述 | 必填 | 默认 |
|---|---|---|---|
AI_AGENT_API_KEY |
用于身份验证的API密钥 | 是 | - |
AI_AGENT_BASE_URL |
AI代理系统的自定义API端点 | 否 | http://localhost:3000 |
故障排除
操作已超时
如果遇到“操作超时”错误，则意味着对AI代理服务的请求所花费的时间比服务器的默认内部超时时间长。您可以通过增加 timeout Cline MCP设置中的值：
{
"mcpServers": {
"ai-agent-mcp": {
"command": "npx",
"args": ["@avi/mcp-ai-agent-server"],
"timeout": 300000, // 5 minutes
"env": {
"AI_AGENT_API_KEY": "your-api-key-here",
"AI_AGENT_BASE_URL": "http://localhost:3000"
}
}
}
}
发展
从源代码构建
git clone https://github.com/avi/mcp-ai-agent-server.git
cd mcp-ai-agent-server
npm install
npm run build
本地测试
# Using MCP Inspector
npx @modelcontextprotocol/inspector ./build/index.js
# Manual testing
AI_AGENT_API_KEY=test-key node ./build/index.js
许可证
麻省理工学院-参见 许可证 了解详情。
