Eventhorizon MCP

🚀 EventHorizon MCP Server

EventHorizon Djangoイベント管理プラットフォームと統合するためのModel Context Protocol (MCP)サーバーです。

🚀 クイックスタート

このサーバーを使用することで、EventHorizon Djangoイベント管理プラットフォームとの統合が可能になります。以下の手順に従ってインストールと設定を行ってください。

📦 インストール

GitHubからのインストール (推奨)

クローンすることなく、npxを使用して直接実行します。

npx github:NotoriousArnav/EventHorizon-MCP

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

git clone https://github.com/NotoriousArnav/EventHorizon-MCP.git
cd EventHorizon-MCP
npm install
npm run build

🔧 設定

環境変数

Knoxトークンの取得方法

1. EventHorizon Djangoインスタンスにログインします。
2. Django Admin > Knox Tokens > Add Tokenにアクセスします。
3. または、APIを使用して POST /api/auth/login/ に資格情報を送信して取得します。

💻 MCPクライアントの設定

Claude Desktop

Linuxの場合は ~/.config/claude/claude_desktop_config.json、macOSの場合は ~/Library/Application Support/Claude/claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "eventhorizon": {
      "command": "npx",
      "args": ["-y", "github:NotoriousArnav/EventHorizon-MCP"],
      "env": {
        "EVENTHORIZON_BASE_URL": "http://localhost:8000",
        "EVENTHORIZON_API_TOKEN": "your_knox_token_here"
      }
    }
  }
}

OpenCode

OpenCodeのMCP設定ファイル (~/.config/opencode/config.json) に以下を追加します。

{
  "mcp": {
    "servers": {
      "eventhorizon": {
        "type": "local",
        "command": ["npx", "-y", "github:NotoriousArnav/EventHorizon-MCP"],
        "env": {
          "EVENTHORIZON_BASE_URL": "http://localhost:8000",
          "EVENTHORIZON_API_TOKEN": "your_knox_token_here"
        }
      }
    }
  }
}

Cursor

CursorのMCP設定に以下を追加します。

{
  "mcpServers": {
    "eventhorizon": {
      "command": "npx",
      "args": ["-y", "github:NotoriousArnav/EventHorizon-MCP"],
      "env": {
        "EVENTHORIZON_BASE_URL": "http://localhost:8000",
        "EVENTHORIZON_API_TOKEN": "your_knox_token_here"
      }
    }
  }
}

ローカル開発時の設定

ソースコードから実行する場合、以下の設定を行います。

{
  "mcpServers": {
    "eventhorizon": {
      "command": "node",
      "args": ["/absolute/path/to/EventHorizon-MCP/dist/index.js"],
      "env": {
        "EVENTHORIZON_BASE_URL": "http://localhost:8000",
        "EVENTHORIZON_API_TOKEN": "your_knox_token_here"
      }
    }
  }
}

✨ 利用可能なツール

イベント管理

登録管理

ユーザー関連

ユーティリティ

🔨 開発

# 依存関係のインストール
npm install

# 開発モードで実行 (ホットリロード)
npm run dev

# 本番用にビルド
npm run build

# 本番ビルドを実行
npm start

# テストを実行
npm test

💻 MCPクライアントなしでのテスト

MCPインスペクターを使用します。

npx @modelcontextprotocol/inspector node dist/index.js

または、生のJSON-RPCを送信します。

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | node dist/index.js

📋 要件

• Node.js 18以上
• Knox認証が有効なEventHorizon Djangoインスタンス

📄 ライセンス

MIT