Saaros-MCP-Server

Saaros-MCP-Server

バックグラウンドスレッドとして実行される、Brave Search APIへのアクセスを提供するModel Context Protocol（MCP）サーバーです。

機能

• バックグラウンドスレッドとして実行されます
• JSON-RPC 2.0プロトコルを実装しています
• レート制限をサポートしています
• Brave Search APIと連携します

セットアップ

1. Brave Search APIキーを設定します。
   • Brave Search APIからAPIキーを取得します
   • プロジェクトのルートに.envファイルを作成します

     BRAVE_API_KEY=your_api_key_here
     

使用方法

サーバーはJSON-RPC 2.0プロトコルを使用して、標準入力／標準出力経由で通信します。リクエストの例を以下に示します。

1. 利用可能なツールの一覧表示：

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "listTools",
    "params": {}
}

2. ウェブ検索の実行：

{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "callTool",
    "params": {
        "name": "brave_web_search",
        "arguments": {
            "query": "your search query",
            "count": 10
        }
    }
}

サーバーを実行するには：

uv run main.py

開発

サーバーはPythonスレッドとして実装されているため、大規模なアプリケーションへの統合に適しています。主なコンポーネントは次のとおりです。

• MCPServer：バックグラウンドスレッドで実行されるメインサーバークラス
• BraveSearchConfig：API設定用の構成クラス
• スレッドセーフな通信を実現するリクエスト／レスポンスキュー