MCP Server (Go)

MCP サーバー（Go）

JSON-RPC インターフェースを通じてデータベースのクエリ機能を提供する、Model Context Protocol（MCP）サーバーの Go 実装です。

機能

• JSON-RPC 2.0 プロトコルの実装
• リアルタイム通信のための Server-Sent Events（SSE）
• SQLite データベースとの統合
• 拡張可能な機能を実現するツールベースのアーキテクチャ
• 認証のサポート

利用可能なツール

1. クエリツール

   • データベースに対して SQL クエリを実行します
   • 結果を表形式で返します

2. テーブル一覧ツール

   • データベース内の利用可能なテーブルをすべて一覧表示します

はじめに

前提条件

• Go 1.x
• SQLite3

インストール

1. リポジトリをクローンします：

git clone <repository-url>
cd mcp_server_go

2. 依存関係をインストールします：

go mod download

設定

サーバーでは、シンプルなトークンベースの認証システムを使用します。期待されるトークンは、サーバー設定に「abcd」としてハードコードされています。

サーバーの実行

go run main.go

サーバーはポート 8777 で起動します。

API ドキュメント

認証

すべてのリクエストには、次の形式の Authorization ヘッダーを含める必要があります：

Authorization: Bearer <token>

エンドポイント

1. ルートエンドポイント（/）

• メソッド：GET
• 目的：Server-Sent Events（SSE）接続を確立します
• レスポンス：メッセージ通信に使用するエンドポイント URL を返します

2. メッセージエンドポイント（/messages/{sessionID}）

• メソッド：POST
• 目的：クライアントリクエストを処理します
• サポート対象のメソッド：
  • initialize：接続を初期化します
  • tools/list：利用可能なツールを一覧表示します
  • tools/call：指定したツールを実行します

使用例

1. 接続を初期化します：

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

2. 利用可能なツールを一覧表示します：

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}

3. クエリを実行します：

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "query",
    "arguments": {
      "query": "SELECT * FROM your_table"
    }
  }
}

プロジェクト構成

mcp_server_go/
├── main.go              # Main server implementation
├── pkg/
│   ├── messages/        # Message structures
│   ├── methods/         # Request handling methods
│   └── tools/           # Tool implementations
└── mcp.db              # SQLite database file