Eventhorizon MCP

🚀 EventHorizon MCP 服務器

EventHorizon MCP 服務器是一個模型上下文協議（MCP）服務器，用於與 EventHorizon Django 事件管理平臺集成。

🚀 快速開始

本項目是用於與 EventHorizon Django 事件管理平臺集成的 MCP 服務器，下面將詳細介紹其安裝、配置等操作。

📦 安裝指南

從 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 管理界面 > Knox Tokens > 添加令牌。
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 許可證。