Smithery Registry MCP

🚀 用於 Smithery 註冊表的 MCP 服務器

本項目是一個與 Smithery 註冊表 API 對接的 MCP 服務器，它允許 AI 代理搜索 MCP 服務器、獲取服務器詳細信息並創建連接 URL。通過實現 llms.txt 中描述的功能，為模型上下文協議（MCP）服務器提供了一種程序化的方式來搜索和獲取啟動配置。

🚀 快速開始

本服務器可助力 AI 代理高效搜索 MCP 服務器、獲取詳細信息並創建連接 URL。以下為你詳細介紹使用前的準備工作。

✨ 主要特性

• 搜索服務器：支持使用語義搜索或特定過濾器查找 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 許可證。