Chronulus AI MCP Server

官方

使用 Chronulus AI 预测和预报代理，预测任何事物。

GitHub

111

文档

Chronulus 的 MCP 服务器

在 Claude 中与 Chronulus AI 预测代理对话

快速入门：Claude for Desktop

安装

Claude for Desktop 目前支持 macOS 和 Windows。

在此处安装 Claude for Desktop

配置

按照此处的通用说明配置 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 配置中，请确保最终参数与您在构建命令中为 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 中与 Chronulus 一起配置文件系统和 fetch 的示例：

{
  "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 Desktop：Settings -> General -> Claude Settings -> Profile (tab)
从 claude.ai/settings：Profile (tab)

偏好设置在 Claude for Desktop 和 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.