クロノス MCP サーバー 🔵

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

概要

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

• **Stellar ウォレットに接続:**秘密キーを使用してウォレットに安全に接続します。

• ウォレット トークンの一覧表示: Stellar ウォレットに保持されているすべてのトークンを取得して一覧表示します。

• 残高照会: XLM やその他の資産のリアルタイムの残高を取得します。

• 資金の送金: Stellar ウォレット間の送金を簡単に開始できます。

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

Related MCP server: AMOCA Solana MCP Server

特徴

• 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は、特に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 のサンプル構成:

{
<<<<<<< HEAD
  "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": []
=======
    "mcpServers": {
        "stellar": {
            "command": "npx",
            "args": [
                "chronos-mcp@latest"
            ],
            "env": {
                "STELLAR_NETWORK": "mainnet",
                "STELLAR_SECRET_KEY": "XXXX"
            },
            "disabled": false,
            "autoApprove": []
        }
>>>>>>> b2501026b3b5ef4c512fceaf340f53b5102a57f9
    }
}

使用法

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

接続ウォレット

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

コマンド例:

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

リストトークン

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

コマンド例:

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

残高を取得する

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

コマンド例:

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

送金

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

パラメータ:

• secretKey : ウォレットの秘密鍵。

• destinationAddress : 受信者のウォレットアドレス。

• amount : 送金する金額。

• asset(オプション) : 転送する資産 (デフォルトは XLM)。

コマンド例:

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

テスト

標準テスト

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

npm test

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

Dockerテスト

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

• Dockerイメージの構築

• Docker Composeでコンテナを実行する

• コンテナの機能のテスト

• よくある問題のトラブルシューティング

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

node test-client.js

このスクリプトは、単純な 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 ブロックチェーンと対話するための包括的な機能セットについて概説しています。