Arcanna MCP Server

🚀 阿卡娜 MCP 服務器

阿卡娜 MCP 服務器允許用戶通過模型上下文協議（MCP）與阿卡娜的人工智能應用場景進行交互，為用戶提供便捷的資源管理、代碼處理、事件查詢等功能。

🚀 快速開始

使用 Claude Desktop 或其他 MCP 客戶端

配置

在你的 MCP 客戶端配置文件（對於 Claude Desktop 為 claude_desktop_config.json）的 mcpServers 部分添加相應條目。

使用 Docker 鏡像（https://hub.docker.com/r/arcanna/arcanna-mcp-server）或 PyPi 包（https://pypi.org/project/arcanna-mcp-server/）

從本倉庫構建本地鏡像

先決條件

• Docker - https://docs.docker.com/engine/install/

配置

1. 切換到包含 Dockerfile 的目錄。
2. 運行以下命令構建鏡像：

docker build -t arcanna/arcanna-mcp-server . --progress=plain --no-cache

3. 將以下配置添加到你的 Claude Desktop/MCP 客戶端配置中：

{
  "mcpServers": {
    "arcanna-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ARCANNA_MANAGEMENT_API_KEY",
        "-e",
        "ARCANNA_HOST",
        "arcanna/arcanna-mcp-server"
      ],
      "env": {
        "ARCANNA_MANAGEMENT_API_KEY": "<ARCANNA_MANAGEMENT_API_KEY>",
        "ARCANNA_HOST": "<YOUR_ARCANNA_HOST_HERE>"
      }
    }
  }
}

✨ 主要特性

• 資源管理：可創建、更新和檢索阿卡娜資源（作業、集成）。
• Python 編碼：支持代碼生成、執行，並能將代碼塊保存為阿卡娜集成。
• 查詢阿卡娜事件：可查詢阿卡娜處理的事件，還能提供多個過濾器。
• 作業管理：能創建、檢索、啟動、停止和訓練作業。
• 反饋系統：可提供對決策的反饋，以提高模型準確性。
• 健康監控：可檢查服務器和 API 密鑰狀態。

📚 詳細文檔

工具

查詢阿卡娜事件

• query_arcanna_events：用於獲取阿卡娜處理的事件，可應用多個過濾器。
• get_filter_fields：用作輔助工具，用於檢索阿卡娜可能的字段以應用過濾器。

資源管理

• upsert_resources：用於創建或更新阿卡娜資源。
• get_resources：用於檢索阿卡娜資源（作業/集成）。
• delete_resources：用於刪除阿卡娜資源。
• integration_parameters_schema：在此上下文中用作輔助工具。

Python 編碼

• generate_code_agent：用於生成代碼。
• execute_code：用於執行生成的代碼。
• save_code：用於將代碼塊保存到阿卡娜管道中作為集成。

作業管理

• start_job：開始作業的事件攝取。
• stop_job：停止作業的事件攝取。
• train_job：使用提供的反饋訓練作業的 AI 模型。

反饋系統

• add_feedback_to_event：提供對 AI 決策的反饋以改進模型準確性。

系統健康

• health_check：驗證服務器狀態和管理 API 密鑰的有效性，返回管理 API 密鑰授權狀態。