Smithery Registry MCP 服务器

一个与 Smithery Registry API 交互的 MCP 服务器，允许 AI 代理搜索 MCP 服务器、获取服务器详细信息以及创建连接 URL。

此服务器实现了 llms.txt 中描述的功能，提供了一种以编程方式搜索和获取模型上下文协议 (MCP) 服务器的启动配置的方法。

功能

• 搜索服务器: 使用语义搜索或特定过滤器查找 MCP 服务器
• 获取服务器详细信息: 检索有关特定服务器的详细信息
• 创建连接 URL: 生成格式正确的 WebSocket URL，其中包含编码的配置

安装

# 克隆仓库
git clone https://github.com/aloshy-ai/smithery-registry-mcp.git
cd smithery-registry-mcp

# 安装依赖
npm install

# 构建项目
npm run build

用法

启动服务器

您可以在两种模式下运行服务器：

STDIO 模式（默认，用于 LLM 客户端）：

npm start

SSE 模式（用于 Web 应用程序）：

npm run sse

环境变量

• PORT: 在 SSE 模式下运行时要监听的端口（默认值：3000）
• HOST: 在 SSE 模式下运行时要绑定的主机（默认值：localhost）
• ENDPOINT: SSE 连接的端点路径（默认值：/sse）
• USE_SSE: 设置为 "true" 以在 SSE 模式下运行，而不是 STDIO 模式

将服务器与 Smithery CLI 结合使用

# 使用 Smithery CLI 安装服务器
npx @smithery/cli install @aloshy-ai/smithery-registry-mcp

# 与各种客户端一起使用
npx @smithery/cli run @aloshy-ai/smithery-registry-mcp --client claude

API 工具

authenticate

使用您的 Smithery API 密钥设置身份验证。

参数：

• apiKey: 您的 Smithery API 密钥

listServers

从 Smithery Registry 搜索并检索服务器列表。

参数：

• query（可选）：搜索查询（语义搜索）
• page（可选，默认值：1）：分页的页码
• pageSize（可选，默认值：10）：每页的项目数

getServer

按其限定名称获取有关特定服务器的详细信息。

参数：

• qualifiedName: 要获取详细信息的服务器的限定名称

createConnectionUrl

使用提供的配置为服务器创建 WebSocket 连接 URL。

参数：

• qualifiedName: 服务器的限定名称
• config: 与服务器架构匹配的配置对象

示例

以下是如何将此服务器与 AI 助手一起使用：

1. 首先使用您的 API 密钥进行身份验证：

authenticate({ apiKey: "your-smithery-api-key" })

2. 搜索与某个主题相关的服务器：

listServers({ query: "web search capabilities" })

3. 获取有关特定服务器的详细信息：

getServer({ qualifiedName: "brave-search" })

4. 使用适当的配置创建连接 URL：

createConnectionUrl({
  qualifiedName: "brave-search",
  config: { apiKey: "your-brave-api-key" }
})

许可证

MIT