Chronulus MCP Server

MCP Server for Chronulus

Chat with Chronulus AI Forecasting & Prediction Agents in Claude

快速入门：Claude桌面版

安装

Claude for Desktop目前可在macOS和Windows上使用。

安装桌面版Claude 这里

配置

遵循一般说明 这里 配置Claude桌面客户端。

您可以在以下位置之一找到您的Claude配置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

然后选择以下最适合您需求的方法之一，并将其添加到您的 claude_desktop_config.json

Using 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": ""
      }
    }
  }
}

注意，如果你收到一个错误，比如“MCP chronulus代理：生成python ENOENT”， 那么，您很可能需要提供绝对路径 python. 例如 /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 而不是仅仅 python

Using 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": ""
      }
    }
  }
}

Using uvx

uvx 将拉取最新版本的 chronulus-mcp 从PyPI注册表中，安装它，然后运行它。

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

注意，如果你得到一个错误，比如“MCP chronulus agents:spawn uvx ENOENT”，那么你很可能需要：

1. 安装uv 或
2. 提供绝对路径 uvx例如 /Users/username/.local/bin/uvx 而不是仅仅 uvx

附加服务器（文件系统、Fetch等）

有关安装和配置第三方服务器的详细信息，请参考服务器维护人员提供的文档。

下面是一个示例，说明如何在您的 claude_desktop_config.json:

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

克劳德偏好

为了简化您在多组工具中使用Claude的体验，最好在Claude设置下添加您的首选项。

您可以通过以下几种方式升级您的Claude首选项：

• 来自克劳德桌面： Settings -> General -> Claude Settings -> Profile (tab)
• 自 claude.ai/设置: Profile (tab)

首选项在Claude for Desktop和Claude.ai（web界面）之间共享。因此，你的指导需要同时适用于这两种体验。

以下是我们用来实现演示中显示的结果的偏好：

## 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.