Smithery Openapi Server

🚀 史密瑟里Registry OpenAPI サーバー

このサーバーは、史密瑟里レジストリ API の OpenAPI インターフェースを提供し、モデルコンテキストプロトコル (MCP) サーバーの起動設定を検索および取得できるようにします。

✨ 主な機能

• 高度なフィルタリング機能を備えた利用可能な MCP サーバーの一覧表示
• 接続設定を含む特定のサーバーの詳細情報の取得
• base64 エンコードされた設定を含む WebSocket URL の生成
• bearer token による認証
• OpenAPI ツールおよびクライアントとの互換性

📦 インストール

pip install -r requirements.txt

🚀 クイックスタート

サーバーの起動

uvicorn main:app --host 0.0.0.0 --port 8000 --reload

API エンドポイント

1. GET /servers - 利用可能な MCP サーバーの一覧表示

   • クエリパラメータ:
     • q: 検索クエリ（意味検索）
     • page: ページ番号（デフォルト: 1）
     • pageSize: 1 ページあたりの項目数（デフォルト: 10）
   • q パラメータで高度なフィルタリング構文を使用:
     • テキスト検索: "machine learning"
     • 所有者フィルタ: owner:username
     • リポジトリフィルタ: repo:repository-name
     • デプロイ状態: is:deployed
     • 例: "owner:smithery-ai repo:fetch is:deployed machine learning"

2. GET /servers/{qualified_name} - 特定のサーバーの詳細情報の取得

3. POST /create-websocket-url - エンコードされた設定を含む WebSocket URL の作成

   • リクエストボディ:

     {
       "qualifiedName": "username/repository",
       "config": {
         // このサーバーのスキーマに合致する設定オブジェクト
       }
     }
     

💻 使用例

基本的な使用法

# サーバーの起動
uvicorn main:app --host 0.0.0.0 --port 8000 --reload

高度な使用法

import { WebSocketClientTransport } from "@modelcontextprotocol/sdk/client/websocket.js"
import { createSmitheryUrl } from "@smithery/sdk/config.js"

const url = createSmitheryUrl(
  "https://your-smithery-mcp-server/ws",
  {
    // 設定オブジェクトはスキーマに合致する必要があります
  },
)
const transport = new WebSocketClientTransport(url)

📚 ドキュメント

WebSocket 接続

MCP サーバーの WebSocket に直接接続します。

• URL 形式: https://server.smithery.ai/${qualifiedName}/ws?config=${base64encode(config)}
• 設定はサーバーの configSchema に合致する必要があります。
• 設定は base64 エンコードされた JSON です。

OpenAPI ツールとの統合

このサーバーは、すべての OpenAPI 互換ツールおよびフレームワークと互換性があるように設計されています。API は RESTful 規約に従い、実行時に詳細な OpenAPI ドキュメントを提供します。/docs エンドポイントにアクセスしてください。

🔧 技術詳細

すべての史密瑟里レジストリ API へのリクエストには認証が必要です。

• Authorization ヘッダーに bearer token を提供する必要があります。
• 形式: Authorization: Bearer your-api-token
• トークンは、史密瑟里のユーザープロファイルの API キーセクションから取得します。

📄 ライセンス

MIT