MCP Server for Chronulus について
MCP Server for Chronulus は、Claude から Chronulus の AI 予測・フォーキャスト用エージェントとやり取りできる MCP サーバーです。Claude Desktop を通じて予測系エージェントを利用したいユーザー向けです。
主な機能
- 01Chronulus 予測エージェントとの対話
- 02PyPI、Docker、uvx によるインストール
- 03CHRONULUS_API_KEY 環境変数による設定
- 04Claude Desktop の設定例
活用シーン
- 01Claude Desktop から AI 予測エージェントを呼び出す
- 02ファイルシステムや fetch などの MCP サーバーと組み合わせる
MCP 対応
Chronulus の予測エージェントをツールとして、Claude Desktop などの MCP クライアントに提供する MCP サーバーです。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Chronulus 用 MCP サーバー
Claude で Chronulus AI の予測エージェントとチャット
クイックスタート:Claude for Desktop
インストール
Claude for Desktop は現在、macOS と Windows で利用できます。
こちらから Claude for Desktop をインストールします。
設定
Claude デスクトップクライアントの設定については、こちらの一般的な手順に従ってください。
Claude の設定ファイルは、次のいずれかの場所にあります。
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
次に、ニーズに最も合う方法を選び、claude_desktop_config.json に追加します。
pip を使用する
(オプション 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 の絶対パスを指定する必要があります。
たとえば、python だけでなく /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 を指定します。
docker を使用する
ここでは、Claude の設定で再利用できる「chronulus-mcp」という docker イメージをビルドします。
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>"
}
}
}
}
uvx を使用する
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」のようなエラーが発生した場合は、次のいずれかが必要です。
- uv をインストールする
uvxの絶対パスを指定する。たとえば、uvxだけでなく/Users/username/.local/bin/uvxを指定します。
追加のサーバー(Filesystem、Fetch など)
デモでは、fetch や filesystem などのサードパーティ製サーバーを使用しています。
サードパーティ製サーバーのインストールと設定の詳細については、サーバーのメンテナーが提供するドキュメントを参照してください。
以下は、claude_desktop_config.json で Chronulus とともに filesystem と fetch を設定する例です。
{
"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 Settings」に好みを追加することをおすすめします。
Claude の設定は、次のいずれかの方法で変更できます。
- Claude Desktop から:
Settings -> General -> Claude Settings -> Profile (tab) - claude.ai/settings から:
Profile (tab)
設定は Claude for Desktop と Claude.ai(ウェブインターフェース)の両方で共有されます。そのため、指示はどちらの環境でも機能する必要があります。
以下は、デモで示した結果を得るために使用した設定です。
## 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.
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。