Chronulus AI MCP Server

chính thức

Dự đoán bất cứ điều gì với các tác nhân dự báo và tiên đoán của Chronulus AI.

GitHub
111

Tài liệu

Chronulus AI

MCP Server cho Chronulus

Trò chuyện với các Tác nhân Dự báo & Dự đoán AI của Chronulus trong Claude

Khởi động nhanh: Claude cho Desktop

Cài đặt

Claude cho Desktop hiện có sẵn trên macOS và Windows.

Cài đặt Claude cho Desktop tại đây

Cấu hình

Làm theo hướng dẫn chung tại đây để cấu hình ứng dụng khách Claude cho desktop.

Bạn có thể tìm thấy tệp cấu hình Claude của mình tại một trong các vị trí sau:

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

Sau đó, chọn một trong các phương pháp sau phù hợp nhất với nhu cầu của bạn và thêm nó vào claude_desktop_config.json của bạn

Sử dụng pip

(Tùy chọn 1) Cài đặt bản phát hành từ PyPI

pip install chronulus-mcp

(Tùy chọn 2) Cài đặt từ 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>"
      }
    }
  }
}

Lưu ý, nếu bạn gặp lỗi như "MCP chronulus-agents: spawn python ENOENT", thì rất có thể bạn cần cung cấp đường dẫn tuyệt đối đến python. Ví dụ /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 thay vì chỉ python

Sử dụng docker

Ở đây chúng ta sẽ xây dựng một image docker có tên 'chronulus-mcp' mà chúng ta có thể tái sử dụng trong cấu hình Claude.

git clone https://github.com/ChronulusAI/chronulus-mcp.git
cd chronulus-mcp
 docker build . -t 'chronulus-mcp'

Trong cấu hình Claude của bạn, hãy đảm bảo rằng đối số cuối cùng khớp với tên bạn đặt cho image docker trong lệnh build.

{
  "mcpServers": {
    "chronulus-agents": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "CHRONULUS_API_KEY", "chronulus-mcp"],
      "env": {
        "CHRONULUS_API_KEY": "<YOUR_CHRONULUS_API_KEY>"
      }
    }
  }
}
Sử dụng uvx

uvx sẽ kéo phiên bản mới nhất của chronulus-mcp từ registry PyPI, cài đặt nó, và sau đó chạy nó.

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

Lưu ý, nếu bạn gặp lỗi như "MCP chronulus-agents: spawn uvx ENOENT", thì rất có thể bạn cần phải:

  1. cài đặt uv hoặc
  2. Cung cấp đường dẫn tuyệt đối đến uvx. Ví dụ /Users/username/.local/bin/uvx thay vì chỉ uvx

Các Máy chủ Bổ sung (Hệ thống tệp, Fetch, v.v.)

Trong bản demo của chúng tôi, chúng tôi sử dụng các máy chủ bên thứ ba như fetch và filesystem.

Để biết chi tiết về cách cài đặt và cấu hình máy chủ bên thứ ba, vui lòng tham khảo tài liệu do nhà duy trì máy chủ cung cấp.

Dưới đây là một ví dụ về cách cấu hình filesystem và fetch cùng với Chronulus trong claude_desktop_config.json của bạn:

{
  "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"]
    }
  }
}

Tùy chọn Claude

Để hợp lý hóa trải nghiệm của bạn khi sử dụng Claude trên nhiều bộ công cụ, tốt nhất là thêm các tùy chọn của bạn vào trong Cài đặt Claude.

Bạn có thể nâng cấp các tùy chọn Claude của mình theo một số cách:

  • Từ Claude Desktop: Settings -> General -> Claude Settings -> Profile (tab)
  • Từ claude.ai/settings: Profile (tab)

Các tùy chọn được chia sẻ trên cả Claude cho Desktop và Claude.ai (giao diện web). Vì vậy, hướng dẫn của bạn cần hoạt động trên cả hai trải nghiệm.

Dưới đây là các tùy chọn chúng tôi đã sử dụng để đạt được kết quả hiển thị trong các bản demo của chúng tôi:

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