Coin MCP 服务器 🚀💰

欢迎来到Coin MCP 服务器——您获取最新加密货币价格的快捷通道，比说"To the moon!"还要快！🌙 本服务器采用FastMCP框架构建，并使用zod进行参数验证，就像一位可靠的加密货币管家，从币安API获取代币价格。🧑‍💼

中文文档 | English

功能概述 🤔

这个项目启动了一个服务器，让您可以通过币安的API查询任何加密货币（以USDT为计价单位）的当前价格。想知道您最爱的代币现在值多少钱？只需询问，价格立刻呈现！💸

工具：getTokenPrice
功能：获取代币的最新价格（例如BGB、BTC、ETH）
优势：速度快、操作简单，由FastMCP驱动！⚡
工具：getAnnoucements
功能：获取公告信息
工具：getCoinInfo
功能：获取指定代币的详细信息
优势：提供代币可转移性、支持的链列表、链网络状态等详细信息

主要特点 🌟

🎯 极简API：只需传递代币符号，即可获取价格。简单直接，毫无繁琐
🛡️ Zod验证：参数检查严格，如同保险库大门般安全
📡 币安集成：直接从币安市场行情API获取实时数据
🧠 错误处理：专业捕捉各种异常并记录日志，方便后续排查

快速开始 🏁

准备好进入加密货币价格查询的世界了吗？以下是运行此服务器的步骤：

前提条件

Deno：需要安装Deno，因为我们采用现代技术栈。从这里下载
币安API访问：无需API密钥——我们直接使用公开接口！但如果您有自定义的BGURL，请将其设置为环境变量

安装

克隆此仓库：

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

安装依赖（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：允许与币安API通信
--allow-env：获取您设置的环境变量BGURL

服务器将以stdio模式启动，像加密货币自动售货机一样随时提供价格！🍔

支持免安装部署，直接部署到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"  // BGB/USDT的最新价格（非真实价格，仅为示例！）

如果代币不存在或API出现问题，将抛出错误并附带一条俏皮的日志，提醒您它已经尽力了。😅

代码揭秘 👀

背后的魔法包括：

FastMCP：启动带有酷炫名称和版本的服务器
Zod：确保token参数的合法性
币安API：从https://api.bitget.com/api/v2/spot/market/tickers获取行情数据

getBitgetPrice函数是核心，从响应中提取甜美的lastPr（最新价格）。查看日志可获取价格更新或错误幽默！😂

环境变量 🌍

BGURL：自定义币安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）。我们将一起解决！🙌

为什么存在这个项目 🎉

因为谁不想实时了解自己加密货币的价值呢？无论您是交易者、长期持有者，还是仅仅对加密货币好奇，这个服务器都能满足您的需求。此外，这也是展示Deno技能和玩转API的有趣方式。😎

贡献指南 🤝

有想法？发现bug？想添加类似月相价格预测的功能？Fork它，修改它，提交PR！让我们共同打造银河系中最酷的MCP服务器。🌌

许可证 📜

MIT——您可以随意使用，但如果您的代币暴涨或暴跌，别怪我！🌑📉

祝您加密货币狩猎愉快，愿您的仓位永远飘红！💚