STARWARCLOUD STARWAR.AI
返回市场
币种-MCP-服务器

币种-MCP-服务器

作者：pwh-pwh27 星标更新：2025-04-15
安装使用来源：spider==github.com

项目介绍

Coin MCP Server 🚀💰

欢迎来到Coin MCP Server——您获取最新加密货币价格的一站式服务，比您说“冲上云霄！”还要快！ 🌙 本项目基于FastMCP构建，并使用zod进行验证，就像一位可靠的加密货币管家一样，从Bitget的API中获取代币价格。 🧑‍💼

中文文档 | English

它能做什么？ 🤔

这个项目启动了一个服务器，让您能够通过Bitget的API查询任何加密货币（与USDT配对）的当前价格。想知道您最喜欢的代币现在值多少钱吗？只需询问，价格就会立即显示！ 💸

  • 工具: getTokenPrice

  • 任务: 获取代币的最新价格（例如：BGB、BTC、ETH）。

  • 超能力: 快速、简单，由FastMCP驱动！ ⚡

  • 工具: getAnnoucements

  • 任务: 获取公告

  • 工具: getCoinInfo

  • 任务: 获取指定代币的详细信息。

  • 超能力: 提供详细的代币信息，如代币可转让性、支持的链列表、链网络状态等。

特点 🌟

  • 🎯 极简API: 传递一个代币符号，获取价格。无需复杂操作。
  • 🛡️ Zod验证: 参数检查严格，如同保险库门一样安全。
  • 📡 Bitget集成: 直接从Bitget的市场行情API获取实时数据。
  • 🧠 错误处理: 像专业人士一样捕捉异常并记录下来，供您日后查看。

开始使用 🏁

准备好潜入加密货币价格池了吗？这里是启动此项目的步骤：

预备条件

  • Deno: 您需要安装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模式启动，随时准备提供价格，就像一台加密货币自动售货机一样！ 🍔

  1. 支持无安装部署到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"  // 最新的BGB/USDT价格（不是真实价格，只是感觉）

如果代币不存在或API出现问题，它会抛出一个带有日志的错误，提醒您它已经尽力了。 😅

代码预览 👀

这是幕后的魔法：

  • FastMCP: 启动具有酷炫名称和版本的服务器。
  • Zod: 确保您的token参数正确。
  • Bitget API: 从https://api.bitget.com/api/v2/spot/market/tickers获取行情数据。

getBitgetPrice函数是关键，从响应中抓取最新的lastPr（最后价格）。查看日志以获取价格更新或错误喜剧金句！ 😂

环境变量 🌍

  • BGURL: 自定义Bitget API基础URL（未设置时默认为https://api.bitget.com）。设置方法如下： 
    export BGURL="https://your-custom-bitget-url.com"

故障排除 🛠️

  • “HTTP错误！状态：404”: 再次检查您的代币符号。BGBUSDT不同于BBGB！
  • “网络错误”: 确保您有互联网连接并且Deno的--allow-net标志已启用。
  • 仍然卡住了？: 向虚空大喊（或打开一个问题）。我们会一起解决的！ 🙌

为什么存在这个项目 🎉

因为谁不想实时知道自己的加密货币资产的价格呢？无论是交易者、HODLer还是仅仅对加密货币感兴趣的人，这个服务器都能为您提供帮助。此外，这也是展示一些Deno技能和玩转API的一种有趣方式。 😎

贡献 🤝

有什么想法？发现了bug？想要添加功能，比如月相价格预测？分叉它，调整它，提交PR！让我们把这个项目变成银河系中最酷的MCP服务器。 🌌

许可证 📜

MIT - 您可以随意使用它，但如果您的代币冲上云霄或暴跌，请不要怪我！ 🌑📉

祝您加密货币狩猎愉快，愿您的袋子永远都是绿色的！ 💚