Chronulus AI MCP Server

oficial

Preveja qualquer coisa com os agentes de previsão e predição da Chronulus AI.

GitHub

111

Documentação

Servidor MCP para Chronulus

Converse com os Agentes de Previsão e Predição da Chronulus AI no Claude

Guia Rápido: Claude para Desktop

Instalação

O Claude para Desktop está disponível atualmente para macOS e Windows.

Instale o Claude para Desktop aqui

Configuração

Siga as instruções gerais aqui para configurar o cliente de desktop do Claude.

Você pode encontrar sua configuração do Claude em um dos seguintes locais:

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

Em seguida, escolha um dos métodos abaixo que melhor atenda às suas necessidades e adicione-o ao seu claude_desktop_config.json

Usando pip

(Opção 1) Instalar a versão do PyPI

pip install chronulus-mcp

(Opção 2) Instalar a partir do 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>"
      }
    }
  }
}

Observação: se você receber um erro como "MCP chronulus-agents: spawn python ENOENT", provavelmente precisará fornecer o caminho absoluto para python. Por exemplo, /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 em vez de apenas python

Usando docker

Aqui vamos construir uma imagem docker chamada 'chronulus-mcp' que podemos reutilizar em nossa configuração do Claude.

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

Na sua configuração do Claude, certifique-se de que o argumento final corresponda ao nome que você deu à imagem docker no comando de build.

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

Usando uvx

uvx irá obter a versão mais recente de chronulus-mcp do registro PyPI, instalá-la e executá-la.

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

Observação: se você receber um erro como "MCP chronulus-agents: spawn uvx ENOENT", provavelmente precisará:

instalar o uv ou
Fornecer o caminho absoluto para uvx. Por exemplo, /Users/username/.local/bin/uvx em vez de apenas uvx

Servidores Adicionais (Filesystem, Fetch, etc)

Em nossa demonstração, usamos servidores de terceiros como fetch e filesystem.

Para detalhes sobre como instalar e configurar servidores de terceiros, consulte a documentação fornecida pelo mantenedor do servidor.

Abaixo está um exemplo de como configurar filesystem e fetch juntamente com o Chronulus no seu 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"]
    }
  }
}

Preferências do Claude

Para otimizar sua experiência ao usar o Claude com vários conjuntos de ferramentas, é recomendável adicionar suas preferências nas Configurações do Claude.

Você pode atualizar suas preferências do Claude de algumas maneiras:

Pelo Claude Desktop: Settings -> General -> Claude Settings -> Profile (tab)
Em claude.ai/settings: Profile (tab)

As preferências são compartilhadas entre o Claude para Desktop e o Claude.ai (a interface web). Portanto, suas instruções precisam funcionar em ambas as experiências.

Abaixo estão as preferências que usamos para alcançar os resultados mostrados em nossas demonstrações:

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