MCP 顾问
MCP 顾问和安装
体验 MCP 顾问
这是什么？
MCP Advisor 是一项发现和推荐服务，可帮助您探索模型上下文协议 (MCP) 服务器。它充当智能向导，帮助 AI 助手基于自然语言查询查找并理解可用的 MCP 服务，从而更轻松地发现并使用合适的工具来完成特定任务。
特征
- 智能搜索：使用自然语言查询查找 MCP 服务
- 丰富的元数据：获取有关每项服务的详细信息
- 实时更新：始终保持最新的 MCP 服务
- 易于集成：可轻松与任何兼容 MCP 的 AI 助手集成
- 向量搜索：基于 OceanBase 实现高性能语义搜索
- 模块化架构：清晰地分离关注点以实现可维护性和可扩展性
建筑学
数据流
快速入门
用法
- 克隆存储库
或者
- 使用
npx
安装
对于 Claude Desktop，编辑您的claude_desktop_config.json文件：
MacOS/Linux
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
视窗
code $env:AppData\Claude\claude_desktop_config.json
交通选择
MCP Advisor 支持两种传输方式：
1. Stdio 传输（默认）
将其用于命令行工具和直接集成。
添加到您的 AI 助手的 MCP 配置以启用服务发现功能：
{
"mcpServers": {
"mcp-advisor": {
"command": "npx",
"args": [
"-y",
"/path/to/repo/build/index.js"
]
}
}
}
2. SSE 传输（HTTP 服务器）
适用于远程服务器或基于 Web 的集成。使用以下命令启动服务器：
# Start with SSE transport on port 3000
TRANSPORT_TYPE=sse SERVER_PORT=3000 ENABLE_FILE_LOGGING=true node build/index.js
SSE 配置的环境变量：
TRANSPORT_TYPE ：设置为sse以使用 SSE 传输（默认为 stdio）SERVER_PORT ：HTTP 服务器端口（默认值：3000）SERVER_HOST ：HTTP 服务器主机（默认值：localhost）SSE_PATH ：SSE 端点路径（默认值：/sse）MESSAGE_PATH ：消息端点路径（默认值：/messages）
使用以下方式连接到服务器：
- SSE 端点：
http://localhost:3000/sse - 消息端点：
http://localhost:3000/messages?sessionId=<SESSION_ID> - 健康检查：
http://localhost:3000/health
3. REST 传输
TRANSPORT_TYPE=rest SERVER_PORT=3000 ENABLE_FILE_LOGGING=true node build/index.js
示例
示例查询
以下是一些可以与 MCP Advisor 一起使用的示例查询：
"Find an MCP server for natural language processing"
"MCP server for financial data analysis"
"Recommendation engine MCP server for e-commerce"
"MCP server with image recognition capabilities"
"Weather data processing MCP server"
"Document summarization MCP server"
示例响应
[
{
"title": "NLP Toolkit",
"description": "Comprehensive natural language processing toolkit with sentiment analysis, entity recognition, and text summarization capabilities.",
"github_url": "https://github.com/example/nlp-toolkit",
"similarity": 0.92
},
{
"title": "Text Processor",
"description": "Efficient text processing MCP server with multilingual support.",
"github_url": "https://github.com/example/text-processor",
"similarity": 0.85
}
]
故障排除
常见问题
- 连接被拒绝
- 确保服务器在指定端口上运行
- 检查防火墙设置
- 验证主机地址是否正确
- 未返回结果
- 尝试更通用的查询
- 检查注册表 API 的网络连接
- 验证 API 端点是否正确配置
- SSE 连接断开
- 增加客户端超时设置
- 检查服务器日志中的错误消息
- 如果从浏览器连接，请确保 CORS 配置正确
- 性能问题
- 考虑添加更具体的搜索词
- 检查服务器资源（CPU/内存）
- 如果频繁进行类似查询，则实施缓存
日志
如需详细排查问题，请检查logs目录中的日志。使用以下命令启用调试日志记录：
DEBUG=true node build/index.js
环境变量
可以使用以下环境变量配置 MCP Advisor：
| 多变的 | 描述 | 默认 | 必需的 |
|---|
TRANSPORT_TYPE | 传输方法（ stdio 、 sse 、 rest ） | stdio | 不 |
SERVER_PORT | SSE/REST 传输的 HTTP 服务器端口 | 3000 | 不 |
SERVER_HOST | 用于 SSE/REST 传输的 HTTP 服务器主机 | localhost | 不 |
SSE_PATH | SSE 端点路径 | /sse | 不 |
MESSAGE_PATH | 消息端点路径 | /messages | 不 |
ENDPOINT | REST 端点路径 | /rest | 不 |
DEBUG | 启用调试日志记录 | false | 不 |
ENABLE_FILE_LOGGING | 启用文件日志记录 | false | 不 |
LOG_LEVEL | 日志级别（调试、信息、警告、错误） | info | 不 |
API 文档
REST API 端点
获取/health
健康检查端点。
回复：
{
"status": "ok",
"version": "1.0.0"
}
获取/sse
用于建立连接的服务器发送事件端点。
查询参数：
回复：
POST /messages
向已建立的 SSE 连接发送消息的端点。
查询参数：
sessionId （字符串，必需）：SSE 连接的会话 ID
请求正文：
{
"jsonrpc": "2.0",
"method": "callTool",
"params": {
"name": "recommend-mcp-servers",
"arguments": {
"query": "financial data analysis"
}
},
"id": "1"
}
回复：
{
"jsonrpc": "2.0",
"result": {
"content": [
{
"title": "Financial Analytics MCP",
"description": "Comprehensive financial data analysis toolkit",
"github_url": "https://github.com/example/financial-mcp",
"similarity": 0.95
}
]
},
"id": "1"
}
POST /rest
用于直接请求的 REST API 端点（使用 REST 传输时）。
请求正文：
{
"jsonrpc": "2.0",
"method": "callTool",
"params": {
"name": "recommend-mcp-servers",
"arguments": {
"query": "financial data analysis"
}
},
"id": "1"
}
**响应：**与/messages端点相同。
测试
与检查员
npx @modelcontextprotocol/inspector
执照
MIT 许可证 - 有关详细信息，请参阅LICENSE文件。