Gopher MCP Server

🚀 Gopher MCP Server

Gopher AI APIへのアクセスを提供するModel Context Protocol (MCP) サーバーです。このサーバーにより、MCPクライアントはGopher AIプラットフォームを通じてデータを検索できます。

✨ 主な機能

• Twitter検索：自然言語クエリを使用してTwitterの投稿を検索します。
• MCP統合：Model Context Protocolクライアントと完全に互換性があります。
• 結果の設定可能：検索結果の最大数を調整できます。
• エラーハンドリング：包括的なエラーハンドリングとレポート機能があります。
• 非同期処理：ポーリングによる非同期API応答を処理します。

📦 インストール

ソースからのインストール

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

git clone https://github.com/gopher-lab/gopher-mcp-server.git
cd gopher-mcp-server

2. サーバーをビルドします：

go build -o gopher-mcp-server ./data

Dockerを使用する場合

docker build -t gopher-mcp-server .

📚 ドキュメント

環境変数

• GOPHER_API：必須 - あなたのGopher AI APIキー
• MAX_RESULTS：任意 - 返す検索結果の最大数（デフォルト: 15）

設定例

export GOPHER_API="your-gopher-api-key-here"
export MAX_RESULTS="20"

💻 使用例

サーバーの起動

# バイナリを使用する場合
./gopher-mcp-server

# Dockerを使用する場合
docker run -e GOPHER_API="your-api-key" gopher-mcp-server

MCPクライアントの設定

このサーバーをあなたのMCPクライアント設定に追加します：

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "gopher-twitter": {
      "command": "./gopher-mcp-server",
      "env": {
        "GOPHER_API": "your-gopher-api-key-here",
        "MAX_RESULTS": "15"
      }
    }
  }
}

Cline設定

{
  "mcpServers": {
    "gopher-twitter": {
      "command": "docker",
      "args": ["run", "--rm", "-e", "GOPHER_API=your-api-key", "gopher-mcp-server"],
      "env": {
        "GOPHER_API": "your-gopher-api-key-here"
      }
    }
  }
}

search_twitterツール

Gopher AI APIを使用してTwitterの投稿を検索します。

パラメーター:

• query (string): 実行する検索クエリ

戻り値:

• tweets (array): 検索クエリに一致するTwitterの投稿の配列
• error (string, optional): 検索が失敗した場合のエラーメッセージ

使用例:

{
  "name": "search_twitter",
  "arguments": {
    "query": "artificial intelligence trends 2024"
  }
}

応答例:

{
  "tweets": [
    {
      "ID": "tweet_123",
      "Content": "Exciting developments in AI this year...",
      "Metadata": {...},
      "Score": 0.95
    }
  ],
  "error": null
}

🔧 技術詳細

Twitter投稿の構造

応答内の各Twitter投稿には以下が含まれます：

• ID: 投稿の一意の識別子
• Content: ツイートのテキスト内容
• Metadata: 投稿に関する追加のメタデータ
• Score: 検索クエリに対する関連性スコア

エラーハンドリング

サーバーはさまざまなエラーシナリオを処理します：

• APIエラー：無効なAPIキー、レート制限、サービス利用不可
• ネットワークエラー：接続タイムアウト、ネットワーク障害
• 処理エラー：検索タイムアウト、無効な応答

エラーメッセージは応答のerrorフィールドに返されます。

開発

# サーバーをビルドする
make build

# テストを実行する
make test

# Dockerイメージをビルドする
make docker-build

依存関係

• github.com/modelcontextprotocol/go-sdk: Go用のMCP SDK
• github.com/tmc/langchaingo: 言語チェーンユーティリティ

トラブルシューティング

一般的な問題

1. APIキーが設定されていない
   • GOPHER_API環境変数が設定されていることを確認してください。
   • APIキーが有効で、適切な権限を持っていることを確認してください。
2. 検索タイムアウト
   • サーバーは最大30回（合計60秒）結果をポーリングします。
   • Gopher AIサービスに遅延が発生していないか確認してください。
3. 結果が返されない
   • 検索クエリが有効であることを確認してください。
   • あなたの条件に一致する投稿があるか確認してください。
   • APIキーがTwitterデータにアクセスできることを確認してください。
4. MCPクライアントの接続問題
   • サーバーのバイナリが実行可能であることを確認してください。
   • MCPクライアントの設定が正しいことを確認してください。
   • サーバーが実行中で、アクセス可能であることを確認してください。

デバッグ

ログレベルを設定することで詳細なログを有効にします：

export LOG_LEVEL=debug
./gopher-mcp-server

コントリビューション

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. 適用可能な場合はテストを追加します。
5. プルリクエストを送信します。

📄 ライセンス

このプロジェクトはApache License 2.0の下でライセンスされています。詳細についてはLICENSEファイルを参照してください。

サポート

問題や質問については：

• GitHubでイシューを作成してください。
• API関連の質問についてはGopher AIのドキュメントを確認してください。
• プロトコル関連の問題についてはMCPのドキュメントを確認してください。