Odinfun Mcp

odinfun-mcp

odinfun-mcp は、Model Context Protocol（MCP） に基づく Odin.fun のサーバー実装です。カニスターの資産管理ツールと OdinFun API ツールを提供し、ブロックチェーン資産の管理やデータ照会に適しています。

このドキュメントは 简体中文 と 繁體中文 でもご覧いただけます。

機能

• カニスター資産管理ツール

  • 残高の照会、出金、新しいトークンの作成
  • BTC によるトークンの売買、数量指定による売買
  • 流動性の追加／削除

• OdinFun API ツール

  • ユーザー認証、ユーザー名の変更、コメントの投稿
  • Odin.fun のトークン一覧、市場データ、ローソク足、保有者、流動性、コメントなどの照会
  • ユーザー資産、作成／お気に入り登録したトークン、流動性、アクティビティ記録などの照会

インストール

npm install odinfun-mcp

使用方法

1. プロジェクトをビルドする

   npm run build
   

2. サーバーを起動する

   サーバーは次の 3 つの起動モードに対応しています。

   • stdio モード（デフォルト）- CLI アプリケーションと統合する場合：

     npm start
     # or
     node dist/server.js
     

     stdin/stdout を使用して通信します。コマンドラインツールや、stdio ベースの MCP 接続に対応するアプリケーションとの統合に適しています。

   • HTTP+SSE モード - Web アプリケーションや最新のクライアント向け（--sse パラメーターを追加）：

     node dist/server.js --sse
     

     次の SSE エンドポイントを備えた HTTP サーバーをポート 3000 で起動します。

     • /sse - SSE 接続エンドポイント
     • /messages?sessionId=<id>&mode=sse - メッセージ処理エンドポイント
     • / - サーバー状態エンドポイント

   • HTTP+Streamable モード - ストリーミング可能な応答が必要なアプリケーション向け（--streamable パラメーターを追加）：

     node dist/server.js --streamable
     

     次のストリーミング可能なエンドポイントを備えた HTTP サーバーをポート 3000 で起動します。

     • /stream - ストリーム接続エンドポイント
     • /messages?sessionId=<id>&mode=streamable - メッセージ処理エンドポイント
     • / - サーバー状態エンドポイント

   注：SSE モードと Streamable モードは同時に有効にできます。

   node dist/server.js --sse --streamable
   

3. MCP プロジェクトに統合する
   これらのツールをインポートして独自の MCP サーバープロジェクトに登録するか、このパッケージが提供するサーバーを直接実行できます。

主なエクスポートとエントリーポイント

• エントリーファイル：dist/server.js
• 型宣言：dist/server.d.ts

主なツールの概要

canisterTools

• canister_getBalance：トークン残高を照会
• canister_withdraw：トークンを出金
• canister_createToken：新しいトークンを作成
• canister_buyTokenWithBtc / canister_sellTokenForBtc：BTC でトークンを売買
• canister_buyTokenAmount / canister_sellTokenAmount：数量を指定してトークンを売買
• canister_addLiquidity / canister_removeLiquidity：流動性を追加／削除

odinFunTools

OdinFun API ツールは、使いやすさと AI との連携向上のため、機能モジュールごとに整理されています。すべてのツール名は標準化され、次のように分類されています。

システムツール

• odinapi_getPriceUnitInfo：Odin.fun API の価格単位に関する情報を取得し、価格値の解釈に役立てます
• odinapi_getFaqInfo：トークン価格、AMM、ボンディングカーブ、プラットフォーム機能の詳細など、Odin.fun の公式 FAQ 情報を取得します

認証ツール

• odinapi_authIdentity：ICP アイデンティティ（Ed25519KeyIdentity）を使用して認証します
• odinapi_identity_postComment：トークンにコメントを投稿します

マーケットツール

• odinapi_market_token_getInfo：トークンの詳細情報（価格、取引量、保有者数など）を取得します
• odinapi_market_token_list：フィルタリングと並べ替えを指定してトークンを一覧表示します
• odinapi_market_price_getBTC：現在の BTC 価格（USD）を取得します
• odinapi_market_price_getHistory：トークンの価格履歴（ローソク足データ）を取得します
• odinapi_market_trade_list：トークンの取引記録を取得します
• odinapi_market_liquidity_getInfo：トークンの流動性情報を取得します
• odinapi_market_liquidity_getUserPositions：ユーザーの流動性ポジションを取得します
• odinapi_comment_getBTCPrice：現在の BTC 価格（USD）を取得します
• odinapi_comment_getTokens：最近アクティブな Odin.fun のトークンを取得します
• odinapi_comment_getTokensByHighestMarketcap：時価総額が最も高い Odin.fun のトークンを取得します
• odinapi_token_getTradesByTime：指定した期間内のトークン取引を取得します
• odinapi_token_getTradesByUser：特定のユーザーによるトークン取引を取得します

ユーザーツール

• odinapi_user_profile_getInfo：ユーザープロフィール情報を取得します
• odinapi_user_profile_list：ユーザーを一覧表示します（検索にも対応）
• odinapi_user_assets_getBalances：ユーザーが保有するすべてのトークン残高を取得します
• odinapi_user_assets_getTokenBalance：特定のトークンの残高を取得します
• odinapi_user_assets_getCreatedTokens：ユーザーが作成したトークンを取得します
• odinapi_user_activity_list：ユーザーのアクティビティ履歴を取得します
• odinapi_user_favorite_list：ユーザーのお気に入りトークンを取得します
• odinapi_user_favorite_toggle：トークンをお気に入りに追加、またはお気に入りから削除します

ソーシャルツール

• odinapi_social_comment_list：トークンに関するコメントを取得します
• odinapi_social_comment_post：トークンにコメントを投稿します
• odinapi_social_activity_feed：すべてのトークンの最近のアクティビティを取得します
• odinapi_social_activity_getTokenActivities：特定のトークンのアクティビティを取得します

共通／ユーティリティツール

• odinapi_tools_price_convert：sats と USD の間で価格を換算します
• odinapi_tools_price_getBTC：現在の BTC 価格（USD）を取得します
• odinapi_tools_search_global：すべてのエンティティ（トークン、ユーザーなど）を横断して検索します
• odinapi_tools_enhance_tokenData：価格、流動性などの情報を追加してトークンデータを拡充します
• odinapi_tools_enhance_userData：残高、アクティビティ、お気に入りなどの情報を追加してユーザーデータを拡充します

すべてのツール名とパラメーターは標準化され、コード内に記載されています。パラメーターの詳細と使用例については、コードベースを参照してください。

ライセンス

MIT