Chronos MCP Server 🔵

Chronos MCP サーバー 🔵

Chronos は、Stellar ブロックチェーンに特化した Model Context Protocol（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 をグローバルにインストールします。

npm install -g chronos-mcp

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

npx chronos-mcp@latest

オプション 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 での 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 で使用するには、次の場所にある 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 の設定例：

{
  "mcpServers": {
    "stellar": {
      "command": "npx",
      "args": ["chronos-mcp@latest"],
      "env": {
        "STELLAR_NETWORK": "mainnet",
        "STELLAR_SECRET_KEY": "your_stellar_secret_key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Claude Desktop と Docker を連携するには、次の設定を使用できます。

{
  "mcpServers": {
    "stellar": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--env-file", "/path/to/your/.env", "chronos-mcp"],
      "env": {
        "STELLAR_NETWORK": "mainnet"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

使用方法

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

connect_wallet

シークレットキーを使用して Stellar ウォレットに接続します。

コマンド例：

「シークレットキー ______ を使ってウォレットに接続して」

---

list_tokens

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

コマンド例：

「ウォレットのトークンを一覧表示して」

---

get_balances

XLM およびその他のアセットの残高を取得します。

コマンド例：

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

---

transfer_funds

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

パラメーター：

• secretKey：ウォレットのシークレットキーです。
• destinationAddress：送金先のウォレットアドレスです。
• amount：送金する金額です。
• asset (任意)：送金するアセットです（デフォルトは XLM）。

コマンド例：

「[送金先のウォレットアドレス] に 0.5 XLM を送金して」

テスト

標準的なテスト

Chronos MCP をローカルでテストするには、次のコマンドを実行します。

npm test

これにより、プロジェクトのテストスイートが実行され、サーバーが想定どおりに動作することを確認できます。

Docker でのテスト

Docker のセットアップをローカルでテストする方法については、手順が記載された Docker 使用ガイドを参照してください。このガイドでは、以下の内容を説明しています。

• Docker イメージのビルド
• Docker Compose を使用したコンテナーの実行
• Claude Desktop との連携
• その他の Docker 関連情報

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

node test-client.js

このスクリプトは、シンプルな MCP リクエストを Docker コンテナーに送信し、応答を表示します。

デプロイ

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

本番環境にデプロイする場合は、Chronos をシステムサービス（systemd、launchd などを使用）でラップして、自動再起動と監視を行うことを検討してください。

Chronos の拡張

Chronos は拡張性を考慮して構築されています。新しいツールを追加するには、次の手順に従ってください。

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

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。

コントリビューション

コントリビューションを歓迎します！問題の報告、プルリクエストの提出、その他のコントリビューションに関する手順については、CONTRIBUTING.md を参照してください。

────────────────────────────── この README は Chronos MCP 専用に作成されており、Node.js パッケージとしてのデプロイ、Claude Desktop との連携、Stellar ブロックチェーンを操作するための包括的な機能について説明しています。