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 key —— 我们像冠军一样直接访问公开端点！但如果你有自定义的 BGURL，可以把它设为环境变量。

安装

1. 像抢热门货一样克隆这个仓库：

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

2. 安装依赖（Deno 会通过 import 自动搞定！）。

运行服务

用下面的命令启动：

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，fork 本项目，登录 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。😎

---

贡献 🤝

有想法？发现了 bug？想添加月相价格预测之类的功能？Fork 它，修改它，提交 PR。让我们一起把它打造成全星系最酷的 MCP 服务。🌌

---

许可证 📜

MIT —— 你想怎么用就怎么用，只是如果你的代币暴涨或暴跌，别怪我！🌑📉

---

祝你加密货币狩猎愉快，愿你的持仓永远飘绿！💚