Kuru MCP Server

🚀 Kuru.io モデルコンテキストプロトコル (MCP) サーバー

このプロジェクトは、Kuru.io仮想通貨取引所のデータにアクセスするためのモデルコンテキストプロトコル（MCP）サーバーを実装しています。これにより、大規模言語モデル（LLM）やAIアシスタントがこのデータを利用できるようになります。

🚀 クイックスタート

Kuru.io MCPサーバーを使うことで、Kuru.io仮想通貨取引所のデータを大規模言語モデルやAIアシスタントが利用できるようになります。以下のセクションでは、サーバーの機能、インストール方法、使用方法などを詳しく説明します。

✨ 主な機能

• 市場データ：リアルタイムの市場データと人気の取引ペアを取得します。
• ツール：現在の価格を確認し、トークンの価値を計算し、利用可能なすべての取引ペアを表示します。
• キャッシュ機構：API呼び出し回数を減らすためのキャッシュ機能が組み込まれています。

📦 インストール

# 依存関係のインストール
npm install

# プロジェクトのビルド
npm run build

💻 使用例

基本的な使用法

サーバーの起動

stdioサーバーとして（ClaudeデスクトップなどのLLMツールに適しています）

npm start

デバッグ用のMCPチェックツール

npm run inspector

MCPツール

このサーバーは以下のツールを提供します。

• get-price - 特定の取引ペアの現在の価格を取得します。

  • パラメータ：symbol - 取引ペアはBASE/QUOTE形式（例：MON/USDC）
  • 例： "MON/USDCの現在の価格はいくらですか？"

• get-all-trading-pairs - すべての利用可能な取引ペアを取得します。

  • 例： "Kuru.io上のすべての利用可能な取引ペアを表示してください。"

• calculate-value - あるトークンの数量を別の通貨での価値に換算します。

  • パラメータ：
    • symbol - 取引ペアはBASE/QUOTE形式（例：MON/USDC）
    • amount - ベーストークンの数量
  • 例： "100 MONはいくらのUSDCに相当しますか？"

高度な使用法

Claudeデスクトップでの使用方法

1. Claudeデスクトップで新しいMCPツールを追加します。
2. "ローカルプロセス"を選択します。
3. サーバーを実行するコマンドを設定します。

   node /path/to/kuru-mcp-server/dist/index.js
   

4. 保存して接続します。

これで、Claudeとの会話でKuru.io MCPツールを使用できます。

サンプルの質問

Claudeに以下の質問を試してみてください。

• "Kuru.io上の現在の人気市場はどれですか？"
• "MON/USDC市場について教えてください。"
• "MON/USDCの現在の価格はいくらですか？"
• "100 MONはいくらのUSDCに相当しますか？"
• "Kuru.io上のすべての利用可能な取引ペアを表示してください。"

📚 ドキュメント

デモ

以下はClaudeを使用してKuru.io MCPサーバーの機能をデモする例です。

🔧 技術詳細

• TypeScriptとNode.jsを使用して構築されています。
• モデルコンテキストプロトコルSDK v1.8.0を採用しています。
• API呼び出し回数を減らすためのキャッシュ機構を実装しています（有効期限は5分）。
• 価格、取引量、流動性情報を含む包括的な市場データを提供します。

📄 ライセンス

このプロジェクトはKuru.ioウェブサイトのAPIを使用し、モデルコンテキストプロトコル仕様を実装しています。