Chronos MCP Server

クロノス MCP サーバー 🔵

Chronosは、Stellarブロックチェーン向けにカスタマイズされたモデルコンテキストプロトコル（MCP）サーバーであり、Claude DesktopなどのAIアプリケーションとの統合に特化して設計されています。Chronosは、Stellarネットワークとの効率的なインタラクションを可能にするオンチェーンツールをAIアシスタントに提供します。

概要

Chronos MCP は次の機能を提供します。

• **Stellar ウォレットに接続:**秘密キーを使用してウォレットに安全に接続します。
• ウォレット トークンの一覧表示: Stellar ウォレットに保持されているすべてのトークンを取得して一覧表示します。
• 残高照会: XLM やその他の資産のリアルタイムの残高を取得します。
• 資金の送金: Stellar ウォレット間の送金を簡単に開始できます。

Chronos は拡張可能に構築されており、標準の Node.js パッケージとして動作するため、base-mcp などの他の MCP サーバーと同様に簡単に展開、インストール、統合できます。

特徴

• Stellar 統合: Horizon API を介して Stellar メインネットと完全に対話します。
• 簡単なデプロイメント: npm を使用して Chronos を公開およびインストールします。
• Claude Desktop の互換性: MCP サーバー構成を更新することで、Claude Desktop とシームレスに統合します。
• **拡張可能なアーキテクチャ:**将来の機能強化や新しいツールの統合に対応するように設計されています。

前提条件

• Node.js (v14以上)
• npm
• Stellar ウォレットの認証情報（接続用の秘密鍵）
• Stellarネットワークとやり取りするためのインターネット接続

インストール

オプション1: npmからインストールする（推奨）

Chronos をグローバルにインストールします。

または、npx で直接使用します。

オプション2: ソースからインストールする

1. リポジトリをクローンします。
   git clone https://github.com/yourusername/chronos-mcp.git cd chronos-mcp
2. 依存関係をインストールします:
   npm install
3. プロジェクトをビルドします。
   npm run build
4. (オプション) アクセスを容易にするためにグローバルにリンクします。
   npm link

オプション3: Dockerを使用する

Docker を使用して Chronos MCP を実行することもできます。

1. Docker イメージをビルドします。
   docker build -t chronos-mcp .
2. コンテナを実行します。
   docker run -it --rm chronos-mcp

Docker Compose のセットアップや Claude Desktop との統合など、Chronos MCP で Docker を使用する詳細な手順については、『 Docker 使用ガイド』を参照してください。

Docker セットアップがローカルで動作するかどうかをテストするには、 「Docker テストガイド」の手順に従ってください。このガイドには、Docker イメージの構築、コンテナの実行、機能のテストに関する手順が記載されています。

構成

環境変数

Chronos MCPは、特にStellar秘密鍵のような機密情報の設定に環境変数を使用します。このプロジェクトでは、開発中に.envファイルから環境変数を読み込むためにdotenv使用しています。

環境変数を構成するには:

1. プロジェクト ルートに.envファイルを作成します。
   STELLAR_SECRET_KEY=your_stellar_secret_key STELLAR_NETWORK=mainnet
2. これらの変数は、アプリケーションの起動時に自動的に読み込まれます。

Docker を使用する場合、環境変数はいくつかの方法で提供できます。

• --env-fileフラグの使用: docker run -it --rm --env-file .env chronos-mcp
• docker-compose.yml でenv_fileディレクティブを使用する
• -eフラグを使用して個々の変数を設定する: docker run -it --rm -e STELLAR_SECRET_KEY=your_key chronos-mcp

クロードデスクトップ構成

Claude Desktop で Chronos を使用するには、次の場所にある Claude Desktop 構成ファイルを更新します。

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

Claude Desktop のサンプル構成:

Claude Desktop と Docker を統合するには、以下を使用できます。

使用法

Chronos MCP は、MCP インターフェースを通じて次のツールを公開します。

接続ウォレット

秘密鍵を使用して Stellar ウォレットに接続します。

コマンド例:

「秘密鍵______を使用してウォレットを接続します」

リストトークン

指定された Stellar ウォレット内のすべてのトークンと資産を一覧表示します。

コマンド例:

「ウォレットトークンを一覧表示する」

残高を取得する

XLM およびその他の資産の残高を取得します。

コマンド例:

「現在のXLM残高はいくらですか？」

送金

ウォレットから別の Stellar ウォレットに資金を転送します。

パラメータ:

• secretKey : ウォレットの秘密鍵。
• destinationAddress : 受信者のウォレットアドレス。
• amount : 送金する金額。
• asset(オプション) : 転送する資産 (デフォルトは XLM)。

コマンド例:

「0.5 XLMを[送信先ウォレットアドレス]に送金する」

テスト

標準テスト

Chronos MCP をローカルでテストするには:

これにより、プロジェクトのテスト スイートが実行され、サーバーが期待どおりに動作していることが検証されます。

Dockerテスト

Dockerのセットアップをローカルでテストするには、詳細な手順についてはDockerテストガイドを参照してください。ガイドの内容は以下のとおりです。

• Dockerイメージの構築
• Docker Composeでコンテナを実行する
• コンテナの機能のテスト
• よくある問題のトラブルシューティング

付属のtest-client.jsスクリプトを使用して Docker コンテナをテストすることもできます。

このスクリプトは、単純な MCP 要求を Docker コンテナに送信し、応答を表示します。

展開

Chronos MCPは標準のNode.jsパッケージとして機能するように設計されており、npmに公開できます。公開後（例： npm publish ）、Chronosは他のMCPサーバーと同様に、グローバルにインストールしたり、npx経由で使用したりできます。

実稼働環境での展開では、自動再起動と監視のために、Chronos をシステム サービス (systemd、launchd などを使用) にラップすることを検討してください。

クロノスの拡張

Chronosは拡張性を考慮して構築されています。新しいツールを追加するには：

1. src/toolsフォルダに新しいディレクトリを作成します。
2. ツールを実装します ( index.ts 、 schemas.ts 、 handlers.tsを含めます)。
3. ツールをsrc/tools/index.tsにエクスポートします。
4. ツールのドキュメントと例を README に更新します。
5. 新しいツールが正しく動作することを確認するためのテストを記述します。

ライセンス

このプロジェクトはMIT ライセンスに基づいてライセンスされています。

貢献

貢献を歓迎します！問題の報告、プルリクエストの送信、その他の貢献手順に関するガイドラインについては、 CONTRIBUTING.md を参照してください。

──────────────────────────────── この README は Chronos MCP 専用に調整されており、Node.js パッケージとしての展開、Claude Desktop との統合、および Stellar ブロックチェーンと対話するための包括的な機能セットについて概説しています。