Chronulus AI MCP Server

oficial

Predice cualquier cosa con los agentes de pronóstico y predicción de Chronulus AI.

GitHub

111

Documentación

Servidor MCP para Chronulus

Chatea con los agentes de predicción y pronóstico de Chronulus AI en Claude

Inicio rápido: Claude para escritorio

Instalación

Claude para escritorio está actualmente disponible en macOS y Windows.

Instala Claude para escritorio aquí

Configuración

Sigue las instrucciones generales aquí para configurar el cliente de escritorio de Claude.

Puedes encontrar tu configuración de Claude en una de las siguientes ubicaciones:

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

Luego elige uno de los siguientes métodos que mejor se adapte a tus necesidades y agrégalo a tu claude_desktop_config.json

Usando pip

(Opción 1) Instalar la versión desde PyPI

pip install chronulus-mcp

(Opción 2) Instalar desde 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>"
      }
    }
  }
}

Nota: si obtienes un error como "MCP chronulus-agents: spawn python ENOENT", lo más probable es que necesites proporcionar la ruta absoluta a python. Por ejemplo /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 en lugar de solo python

Usando docker

Aquí construiremos una imagen docker llamada 'chronulus-mcp' que podemos reutilizar en nuestra configuración de Claude.

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

En tu configuración de Claude, asegúrate de que el argumento final coincida con el nombre que le das a la imagen docker en el comando de construcción.

{
  "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 obtendrá la última versión de chronulus-mcp del registro PyPI, la instalará y luego la ejecutará.

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

Nota: si obtienes un error como "MCP chronulus-agents: spawn uvx ENOENT", lo más probable es que necesites:

instalar uv o
Proporcionar la ruta absoluta a uvx. Por ejemplo /Users/username/.local/bin/uvx en lugar de solo uvx

Servidores adicionales (Filesystem, Fetch, etc.)

En nuestra demostración, usamos servidores de terceros como fetch y filesystem.

Para obtener detalles sobre cómo instalar y configurar servidores de terceros, consulta la documentación proporcionada por el mantenedor del servidor.

A continuación se muestra un ejemplo de cómo configurar filesystem y fetch junto con Chronulus en tu 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"]
    }
  }
}

Preferencias de Claude

Para optimizar tu experiencia al usar Claude con múltiples conjuntos de herramientas, es mejor agregar tus preferencias en la configuración de Claude.

Puedes actualizar tus preferencias de Claude de varias maneras:

Desde Claude para escritorio: Settings -> General -> Claude Settings -> Profile (tab)
Desde claude.ai/settings: Profile (tab)

Las preferencias se comparten entre Claude para escritorio y Claude.ai (la interfaz web). Por lo tanto, tus instrucciones deben funcionar en ambas experiencias.

A continuación se muestran las preferencias que utilizamos para lograr los resultados mostrados en nuestras demostraciones:

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