Chronulus AI MCP Server

官方

使用 Chronulus AI 預測與預報代理，預測任何事物。

GitHub

111

文件

Chronulus 的 MCP 伺服器

在 Claude 中與 Chronulus AI 預測與預言代理對話

快速入門：Claude 桌面版

安裝

Claude 桌面版目前支援 macOS 和 Windows。

請在此處安裝 Claude 桌面版

設定

請依照此處的一般說明來設定 Claude 桌面用戶端。

您可以在下列其中一個位置找到您的 Claude 設定檔：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json

然後選擇以下最符合您需求的方法之一，並將其新增至您的 claude_desktop_config.json

使用 pip

（選項 1）從 PyPI 安裝發行版

pip install chronulus-mcp

（選項 2）從 Github 安裝

git clone https://github.com/ChronulusAI/chronulus-mcp.git
cd chronulus-mcp
pip install .

{
  "mcpServers": {
    "chronulus-agents": {
      "command": "python",
      "args": ["-m", "chronulus_mcp"],
      "env": {
        "CHRONULUS_API_KEY": "<YOUR_CHRONULUS_API_KEY>"
      }
    }
  }
}

請注意，如果您遇到類似「MCP chronulus-agents: spawn python ENOENT」的錯誤，那麼您很可能需要提供 python 的絕對路徑。例如，使用 /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 而不僅僅是 python

使用 docker

在此我們將建立一個名為「chronulus-mcp」的 docker 映像檔，以便在 Claude 設定中重複使用。

git clone https://github.com/ChronulusAI/chronulus-mcp.git
cd chronulus-mcp
 docker build . -t 'chronulus-mcp'

在您的 Claude 設定中，請確保最後一個引數與您在 build 指令中為 docker 映像檔指定的名稱相符。

{
  "mcpServers": {
    "chronulus-agents": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "CHRONULUS_API_KEY", "chronulus-mcp"],
      "env": {
        "CHRONULUS_API_KEY": "<YOUR_CHRONULUS_API_KEY>"
      }
    }
  }
}

使用 uvx

uvx 會從 PyPI 登錄庫拉取最新版本的 chronulus-mcp，安裝後再執行。

{
  "mcpServers": {
    "chronulus-agents": {
      "command": "uvx",
      "args": ["chronulus-mcp"],
      "env": {
        "CHRONULUS_API_KEY": "<YOUR_CHRONULUS_API_KEY>"
      }
    }
  }
}

請注意，如果您遇到類似「MCP chronulus-agents: spawn uvx ENOENT」的錯誤，那麼您很可能需要：

安裝 uv 或
提供 uvx 的絕對路徑。例如，使用 /Users/username/.local/bin/uvx 而不僅僅是 uvx

其他伺服器（檔案系統、Fetch 等）

在我們的示範中，我們使用了第三方伺服器，例如 fetch 和 filesystem。

有關安裝和設定第三方伺服器的詳細資訊，請參考伺服器維護者提供的文件。

以下是如何在您的 claude_desktop_config.json 中，將 filesystem 和 fetch 與 Chronulus 一同設定的範例：

{
  "mcpServers": {
    "chronulus-agents": {
      "command": "uvx",
      "args": ["chronulus-mcp"],
      "env": {
        "CHRONULUS_API_KEY": "<YOUR_CHRONULUS_API_KEY>"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/AIWorkspace"
      ]
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}

Claude 偏好設定

為了簡化您跨多組工具使用 Claude 的體驗，最好在 Claude 設定中加入您的偏好設定。

您可以透過以下幾種方式更新您的 Claude 偏好設定：

從 Claude 桌面版：Settings -> General -> Claude Settings -> Profile (tab)
從 claude.ai/settings：Profile (tab)

偏好設定在 Claude 桌面版和 Claude.ai（網頁介面）之間是共用的。因此，您的指令需要同時適用於這兩種體驗。

以下是我們在示範中達到所示結果所使用的偏好設定：

## Tools-Dependent Protocols
The following instructions apply only when tools/MCP Servers are accessible.

### Filesystem - Tool Instructions
- Do not use 'read_file' or 'read_multiple_files' on binary files (e.g., images, pdfs, docx) .
- When working with binary files (e.g., images, pdfs, docx) use 'get_info' instead of 'read_*' tools to inspect a file.

### Chronulus Agents - Tool Instructions
- When using Chronulus, prefer to use input field types like TextFromFile, PdfFromFile, and ImageFromFile over scanning the files directly.
- When plotting forecasts from Chronulus, always include the Chronulus-provided forecast explanation below the plot and label it as Chronulus Explanation.