MCP Server for Chronulus

本地服务

chronulus.comAI 与智能体11179 周前更新

代码仓库访问官网

关于 MCP Server for Chronulus

MCP Server for Chronulus 是一个让用户在 Claude 中与 Chronulus AI 预测与预报 Agent 交互的 MCP 服务。适合需要通过 Claude 使用预测类 Agent 的用户。

主要功能

01与 Chronulus 预测 Agent 交互
02支持 PyPI、Docker 与 uvx 安装
03通过 CHRONULUS_API_KEY 环境变量配置
04提供 Claude Desktop 配置示例

适用场景

01在 Claude Desktop 中调用 AI 预测 Agent
02与文件系统、fetch 等其他 MCP 服务组合使用

MCP 相关

该项目是一个 MCP 服务，将 Chronulus 预测与预报 Agent 以工具形式提供给 Claude Desktop 等 MCP 客户端。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "chronulus": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "build"
      ]
    }
  }
}

启动命令docker run -i --rm build

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

ocibuildstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Chronulus 的 MCP 服务

在 Claude 中与 Chronulus AI 预测 Agent 对话

快速入门：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 配置中，请确保最后一个参数与构建命令中为 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

其他服务（Filesystem、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 桌面版和 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.

支持 Markdown

登录后评论