使用说明
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": "<YOUR_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": "<YOUR_CHRONULUS_API_KEY>"
}
}
}
}
Using uvx
uvx 将拉取最新版本的 chronulus-mcp 从PyPI注册表中，安装它，然后运行它。
{
"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等）
在我们的演示中，我们使用第三方服务器，如 获取 和 文件系统.
有关安装和配置第三方服务器的详细信息，请参考服务器维护人员提供的文档。
下面是一个示例，说明如何在您的 claude_desktop_config.json:
{
"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首选项：
- 来自克劳德桌面：
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.
