Ergs MCP

🚀 Ergs MCP Server

Model Context Protocol (MCP)サーバーで、Ergs APIとのやり取りに必要なツールを提供します。このサーバーにより、AIアシスタントやその他のMCPクライアントは、ErgsのWeb APIを通じてデータソースを検索および閲覧できます。

🚀 クイックスタート

Ergs MCP Serverは、Model Context Protocol (MCP)に基づいたサーバーで、Ergs APIとのやり取りを容易にします。これにより、AIアシスタントやMCPクライアントがデータソースを検索・閲覧できます。

✨ 主な機能

• Ergs APIとのやり取りを可能にするMCPサーバー。
• AIアシスタントやMCPクライアントがデータソースを検索・閲覧できる。

📦 インストール

ソースからビルド

git clone https://github.com/rubiojr/ergs-mcp
cd ergs-mcp
go build -o ergs-mcp

Go Installを使用する

go install github.com/rubiojr/ergs-mcp@latest

📚 ドキュメント

設定

MCPサーバーはErgs Webサーバーに接続します。デフォルトでは、Ergsがhttp://localhost:8080で実行されていることを想定しています。

環境変数

• ERGS_URL: Ergs WebサーバーのベースURL (デフォルト: http://localhost:8080)

例

# デフォルトのErgs URL (localhost:8080)を使用する
./ergs-mcp

# カスタムのErgsインスタンスに接続する
ERGS_URL=http://ergs.example.com:3000 ./ergs-mcp

使用方法

Ergs Webサーバーの起動

まず、Ergs Webサーバーが実行されていることを確認してください。

ergs web --port 8080

MCPサーバーの実行

MCPサーバーを起動します。

./ergs-mcp

サーバーはMCPプロトコルを使用して標準入出力を介して通信します。

MCPクライアントの設定

Claude Desktop

Claude Desktopの設定ファイル (macOSでは~/Library/Application Support/Claude/claude_desktop_config.json) に以下を追加します。

{
  "mcpServers": {
    "ergs": {
      "command": "/path/to/ergs-mcp",
      "env": {
        "ERGS_URL": "http://localhost:8080"
      }
    }
  }
}

Zed Editor

Zedの設定ファイル (Linuxでは~/.config/zed/settings.json、macOSでは~/Library/Application Support/Zed/settings.json`) に以下を追加します。

{
  "context_servers": {
    "ergs": {
      "command": {
        "path": "/absolute/path/to/ergs-mcp",
        "args": [],
        "env": {
          "ERGS_URL": "http://localhost:8080"
        }
      }
    }
  }
}

/absolute/path/to/ergs-mcpを実際のバイナリのパスに置き換えてください。

その他のMCPクライアント

MCPクライアントを設定して、ergs-mcpバイナリを実行し、標準入出力を介して通信するようにします。

ビルド

go build -o ergs-mcp

テスト

Ergs Webサーバーが実行されていることを確認してから、MCPサーバーをテストします。

# 1つのターミナルでErgs Webサーバーを起動する
ergs web --port 8080

# 別のターミナルでMCPサーバーを実行する
./ergs-mcp

📄 ライセンス

MITライセンス - 詳細はErgsプロジェクトを参照してください。

🔗 リンク

• Ergs - メインのErgsプロジェクト
• MCP Go SDK - Model Context ProtocolのGo SDK
• Model Context Protocol - MCP仕様