Coin MCP Server 🚀💰

Coin MCP サーバー 🚀💰

Coin MCP サーバーへようこそ – 「To the moon!」と言うより速く最新の暗号通貨価格を入手できる、オールインワンのツールです 🌙 FastMCP で構築し、バリデーションのために zod で味付けしたこの小さなサーバーは、信頼できる暗号通貨の執事のように、Bitget の API からトークン価格を取得します。🧑‍💼

中文文档 | English

---

これは何をするの？ 🤔

このプロジェクトは、Bitget の優れた API を使って、任意の暗号通貨（USDT ペア）の現在価格を照会できるサーバーを起動します。お気に入りのトークンの価値が今いくらなのか知りたいですか？聞くだけで、ほら – 価格が手に入ります！ 💸

• ツール: getTokenPrice

• ミッション: トークン（例: BGB、BTC、ETH）の最新価格を取得します。

• スーパーパワー: 高速で、シンプルで、FastMCP によって動いています！ ⚡

• ツール: getAnnoucements

• ミッション: お知らせを取得します

• ツール: getCoinInfo

• ミッション: 指定したトークンの詳細情報を取得します。

• スーパーパワー: トークンの転送可否、対応チェーン一覧、チェーンネットワークのステータスなど、詳細情報を提供します。

---

機能 🌟

• 🎯 超シンプルな API: トークンシンボルを渡すと、価格が返ってきます。面倒もごちゃごちゃもなし。
• 🛡️ Zod によるバリデーション: パラメータは金庫の扉よりも厳重にチェックされます。
• 📡 Bitget 連携: Bitget のマーケットティッカー API から直接ライブデータを取得します。
• 🧠 エラー処理: 問題をプロのように捕捉し、後で笑えるようにログに記録します。

---

はじめに 🏁

暗号通貨価格のプールに飛び込みたいですか？この子を動かす方法は次のとおりです:

前提条件

• Deno: 私たちはおしゃれでモダンなので、Deno がインストールされている必要があります。こちらから入手してください。
• Bitget API アクセス: API キーは不要です – チャンプのようにパブリックエンドポイントを叩いています！ただし、カスタムの BGURL がある場合は、環境変数として設定してください。

インストール

1. 熱いうちにこのリポジトリをクローンします:

   git clone https://github.com/pwh-pwh/coin-mcp-server.git
   cd coin-mcp-server
   

2. 依存関係をインストールします（Deno はインポートを通じてこれを自動的に処理します！）。

サーバーの実行

次のコマンドで起動します:

deno run --allow-net --allow-env --allow-read main.ts

または

deno run --allow-net --allow-env --allow-read https://deno.land/x/coin_mcp_server/main.ts

• --allow-net: Bitget の API と通信できるようにします。
• --allow-env: 設定していれば BGURL 環境変数を取得します。

サーバーは stdio モードで起動し、暗号通貨の自動販売機のように価格を提供する準備が整います！ 🍔

3. インストール不要に対応し、deno に直接デプロイできます。このプロジェクトをフォークし、dash.deno.com にログインし、環境変数 StartType=sse を設定すると、deno が提供するドメイン名を使って sse モードで接続できます

---

設定

config.json

{
  "mcpServers": {
    "coin-mcp": {
      "command": "deno",
      "args": [
        "run",
        "--allow-net",
        "--allow-read",
        "--allow-env",
        "https://deno.land/x/coin_mcp_server/main.ts"
      ]
    }
  }
}

使用例 🎮

getTokenPrice を呼び出す方法は次のとおりです:

{
  "tool": "getTokenPrice",
  "parameters": {
    "token": "BGB"
  }
}

レスポンス:

"42.069"  // The latest BGB/USDT price (not a real price, just vibes!)

トークンが存在しない場合や API が問題を起こした場合は、最善を尽くしたことを思い出させるおちゃめなログとともにエラーをスローします。😅

---

コードをちょっと覗き見 👀

幕の裏側の魔法は次のとおりです:

• FastMCP: かっこいい名前とバージョンでサーバーを起動します。
• Zod: token パラメータをチェックします。
• Bitget API: https://api.bitget.com/api/v2/spot/market/tickers からティッカーデータを取得します。

getBitgetPrice 関数が MVP で、レスポンスから甘い lastPr（最終価格）を取得します。価格の更新やエラーの喜劇的な金塊についてはログを確認してください！ 😂

---

環境変数 🌍

• BGURL: カスタム Bitget API ベース URL（設定しない場合は https://api.bitget.com がデフォルトです）。次のように設定します:

  export BGURL="https://your-custom-bitget-url.com"
  

---

トラブルシューティング 🛠️

• 「HTTP error! status: 404」: トークンシンボルを再確認してください。BGBUSDT は BGB と同じではありません！
• 「Network error」: インターネットに接続されていることと、Deno の --allow-net フラグがあることを確認してください。
• まだ行き詰まっていますか？: 虚空に向かって叫ぶ（または issue を開く）してください。一緒に解決しましょう！ 🙌

---

これが存在する理由 🎉

なぜなら、自分の暗号通貨の資産の価格をリアルタイムで知りたくない人なんていないからです。トレーダーでも、HODLer でも、ただ暗号通貨に興味があるだけでも、このサーバーが味方になります。さらに、Deno スキルをアピールして API で遊ぶ楽しい方法でもあります。😎

---

コントリビューション 🤝

アイデアがありますか？バグを見つけましたか？月相の価格予測のような機能を追加したいですか？フォークして、手を加えて、PR を送ってください！これを銀河で最もクールな MCP サーバーにしましょう。🌌

---

ライセンス 📜

MIT – 好きなように使ってください。ただし、あなたのトークンが急騰しても暴落しても、私を責めないでください！ 🌑📉

---

ハッピー・クリプトハンティング、そしてあなたの保有資産がいつもグリーンでありますように！ 💚