相关性MCP服务器
A. Smithery（此处可能指与“Smith”相关的某种工艺或制造领域，但直接翻译无对应中文词汇，若作为专有名词或特定概念，需根据上下文确定具体含义，以下为一种可能的翻译）：史密斯工艺/史密斯制造（或根据具体语境调整为更贴切的表述）兼容MCP（模型上下文协议）的服务器，该服务器提供 相关性人工智能（或译为：关联人工智能） 为MCP客户端提供工具。
概述
此服务器允许您通过任何兼容MCP的客户端使用您的Relevance AI工具。只需配置您的Relevance AI凭据以及您希望公开使用的工具ID，服务器将动态地将它们注册为MCP工具。
特性/功能
- 动态工具注册根据配置自动获取并注册Relevance AI工具
- 类型安全配置使用Zod模式进行强大的配置验证
- 异步工具执行处理Relevance AI的异步作业执行模式
- 错误处理针对API故障和超时的全面错误处理
- 单元测试包含基于Jest的配置和服务器逻辑单元测试
先决条件
- Node.js >= 18
- A. Relevance AI账户
- 相关性AI API凭证：
- API密钥 - 地区（例如，“us”表示美国，“au”表示澳大利亚） - 项目UUID - 您希望公开的工具ID
入门指南
安装
npm install配置
服务器需要以下配置参数：
- API密钥你的Relevance AI API密钥（在“账户”>“集成”>“Relevance API密钥”中找到）
- 地区您的Relevance AI区域（例如，“us”表示美国，“au”表示澳大利亚）
- 项目您的Relevance AI项目唯一标识符（UUID）
- 工具ID作为MCP工具暴露的相关AI工具ID数组
发展
使用Smithery以开发模式运行服务器：
npm run dev这将启动服务器，并使其通过Smithery Playground可用。
测试
运行单元测试：
npm test建筑
为生产环境构建服务器：
npm run build部署
部署到Smithery
- 创建一个GitHub仓库并推送你的代码：
git remote add origin https://github.com/YOUR_USERNAME/relevance_mcp.git
git push -u origin main- 首选 “Smithery”可以翻译为“铁匠铺”或“锻造工坊”。这个词汇源自英语，其中“Smith”通常指的是铁匠或锻造工匠，而“ery”则表示一个地方或场所，因此“Smithery”整体上指的是进行铁匠工作或锻造活动的地方 并点击“部署”
- 连接您的GitHub仓库
- 在部署设置中配置您的Relevance AI凭据
它是如何运作的
- 配置服务器从配置中读取您的Relevance AI凭据和工具ID
- 工具发现启动时，它会从Relevance AI API获取每个已配置工具的元数据
- 模式映射它将Relevance AI的参数模式转换为MCP兼容的Zod模式
- 工具注册每个Relevance AI工具都被注册为MCP工具
- 执行当调用一个工具时：
- 服务器使用提供的参数触发Relevance AI工具 - 它会轮询作业状态，直到作业完成（最长60秒） - 输出以MCP格式返回
API 参考文档
Relevance AI 客户端
这个 RelevanceClient 该类处理与Relevance AI API的所有交互：
listTools()列出项目中所有可用的工具retrieveTool(toolId)检索特定工具的元数据executeTool(toolId, params)触发工具的异步执行getJobStatus(toolId, jobId)检查作业的状态waitForJobCompletion(toolId, jobId, timeout)等待作业完成
建筑学
src/
├── index.ts # Main MCP server implementation
├── relevance-client.ts # Relevance AI API client
test/
├── config.test.ts # Configuration schema tests
├── server.test.ts # Server logic tests故障排除
未找到工具
确保工具ID存在于您的Relevance AI项目中，并且可以使用您的API密钥访问。
认证错误
请验证您的API密钥、区域和项目UUID是否正确。您可以在Relevance AI帐户的“帐户”>“集成”下找到这些信息。
超时错误
默认超时时间为60秒。如果您的工具执行时间更长，您可能需要修改超时设置 relevance-client.ts。
贡献；做出贡献
欢迎贡献！请随时提交拉取请求。
许可证
ISC（Internet Service Provider，互联网服务提供商）