Smithery Registry MCP

🚀 用于 Smithery 注册表的 MCP 服务器

本项目是一个与 Smithery 注册表 API 对接的 MCP 服务器，它允许 AI 代理搜索 MCP 服务器、获取服务器详细信息并创建连接 URL。该服务器实现了 llms.txt 中描述的功能，为搜索和获取启动配置以用于模型上下文协议（MCP）服务器提供了一种程序化的方式。

🚀 快速开始

本服务器可帮助你便捷地与 Smithery 注册表进行交互，以下是使用前的准备步骤。

✨ 主要特性

• 搜索服务器：支持使用语义搜索或特定过滤器查找 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 模式（适用于网页应用程序）：

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

高级用法

以下是使用此服务器与 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" }
})

📚 详细文档

API 工具

authenticate

使用 Smithery API 密钥进行身份验证。 参数：

• apiKey：你的 Smithery API 密钥

listServers

从 Smithery 注册表搜索并检索服务器列表。 参数：

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

getServer

根据其限定名称获取特定服务器的详细信息。 参数：

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

createConnectionUrl

为指定配置的服务器创建 WebSocket 连接 URL。 参数：

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

📄 许可证

本项目采用 MIT 许可证。