relevance MCP

相关性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

1. 创建一个GitHub仓库并推送你的代码：

git remote add origin https://github.com/YOUR_USERNAME/relevance_mcp.git
git push -u origin main

1. 首选 “Smithery”可以翻译为“铁匠铺”或“锻造工坊”。这个词汇源自英语，其中“Smith”通常指的是铁匠或锻造工匠，而“ery”则表示一个地方或场所，因此“Smithery”整体上指的是进行铁匠工作或锻造活动的地方 并点击“部署”
2. 连接您的GitHub仓库
3. 在部署设置中配置您的Relevance AI凭据

它是如何运作的

1. 配置服务器从配置中读取您的Relevance AI凭据和工具ID
2. 工具发现启动时，它会从Relevance AI API获取每个已配置工具的元数据
3. 模式映射它将Relevance AI的参数模式转换为MCP兼容的Zod模式
4. 工具注册每个Relevance AI工具都被注册为MCP工具
5. 执行当调用一个工具时：

- 服务器使用提供的参数触发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，互联网服务提供商）

资源

• Relevance AI 文档
• Relevance AI SDK（软件开发工具包）
• Smithery 文档
• MCP TypeScript SDK（MCP TypeScript软件开发工具包）