Chronulus MCP Server

<div align="center"> <img width="150px" src="https://www.chronulus.com/brand-assets/chronulus-logo-blue-on-alpha-square.png" alt="Chronulus AI"> <h1 align="center">Chronulus 的 MCP 服务器</h1> <h3 align="center">在 Claude 中与 Chronulus AI 预测和预测代理聊天</h3> </div>

快速入门：Claude 桌面版

安装

Claude 桌面版目前可在 macOS 和 Windows 上使用。

在此处安装 Claude 桌面版 here

配置

按照 此处 的通用说明配置 Claude 桌面客户端。

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

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

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

<details> <summary>使用 pip</summary>

（选项 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

</details>

<details> <summary>使用 docker</summary>

在这里，我们将构建一个名为“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>"
      }
    }
  }
}

</details>

<details> <summary>使用 uvx</summary>

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" 的错误，那么您很可能需要：

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

</details>

其他服务器（文件系统、Fetch 等）

在我们的演示中，我们使用了第三方服务器，例如 fetch 和 filesystem。

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

以下是如何在您的 claude_desktop_config.json 中配置文件系统和 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 桌面版：设置 -> 常规 -> Claude 设置 -> 个人资料（选项卡）
• 从 claude.ai/settings: 个人资料（选项卡）

偏好设置在 Claude 桌面版和 Claude.ai（Web 界面）之间共享。因此，您的说明需要在两种体验中都有效。

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

## 工具相关协议
以下说明仅在工具/MCP 服务器可访问时适用。

### 文件系统 - 工具说明
- 不要对二进制文件（例如，图像、pdf、docx）使用“read_file”或“read_multiple_files”。
- 在处理二进制文件（例如，图像、pdf、docx）时，使用“get_info”而不是“read_*”工具来检查文件。

### Chronulus 代理 - 工具说明
- 使用 Chronulus 时，首选使用 TextFromFile、PdfFromFile 和 ImageFromFile 等输入字段类型，而不是直接扫描文件。
- 在绘制 Chronulus 的预测时，始终在图下方包含 Chronulus 提供的预测解释，并将其标记为 Chronulus 解释。