MCP Server for Chronulus
Chat with Chronulus AI Forecasting & Prediction Agents in Claude
Quickstart: Claude for Desktop
Install
Claude for Desktop is currently available on macOS and Windows.
Install Claude for Desktop here
Configuration
Follow the general instructions here to configure the Claude desktop client.
You can find your Claude config at one of the following locations:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
Then choose one of the following methods that best suits your needs and add it to your claude_desktop_config.json
Using pip
(Option 1) Install release from PyPI
pip install chronulus-mcp
(Option 2) Install from 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>"
}
}
}
}
Note, if you get an error like "MCP chronulus-agents: spawn python ENOENT",
then you most likely need to provide the absolute path to python.
For example /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 instead of just python
Using docker
Here we will build a docker image called 'chronulus-mcp' that we can reuse in our Claude config.
git clone https://github.com/ChronulusAI/chronulus-mcp.git
cd chronulus-mcp
docker build . -t 'chronulus-mcp'
In your Claude config, be sure that the final argument matches the name you give to the docker image in the build command.
{
"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 will pull the latest version of chronulus-mcp from the PyPI registry, install it, and then run it.
{
"mcpServers": {
"chronulus-agents": {
"command": "uvx",
"args": ["chronulus-mcp"],
"env": {
"CHRONULUS_API_KEY": "<YOUR_CHRONULUS_API_KEY>"
}
}
}
}
Note, if you get an error like "MCP chronulus-agents: spawn uvx ENOENT", then you most likely need to either:
- install uv or
- Provide the absolute path to
uvx. For example /Users/username/.local/bin/uvx instead of just uvx
Additional Servers (Filesystem, Fetch, etc)
In our demo, we use third-party servers like fetch and filesystem.
For details on installing and configure third-party server, please reference the documentation provided by the server maintainer.
Below is an example of how to configure filesystem and fetch alongside Chronulus in your 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
... View full README on GitHub
