加密货币价格查询服务

一个通过CoinGecko API提供加密货币价格信息的简单MCP服务器。

  • by marcosnunesmbs
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 marcosnunesmbs/mcp_coingecko_price_ts

使用说明

CoinGecko价格MCP服务器

一个简单的模型上下文协议(MCP)服务器,使用CoinGecko API提供加密货币定价信息。

特性

  • 加密价格:一种获取特定货币加密货币当前价格的工具。
    • 输入:
      • crypto_id:加密货币的CoinGecko ID(例如“比特币”、“以太坊”)。
      • currency:价格的目标货币(例如,“usd”、“brl”)。

先决条件

  • Node.js(建议使用v18或更高版本)
  • npm

安装

  1. 克隆或导航到项目存储库。

  2. 安装依赖项:

    npm install
    

建设项目

将TypeScript代码编译为JavaScript:

npm run build

编译后的输出将在 dist 目录。

用法

使用MCP检查员进行本地测试( npx 方式)

您可以使用MCP检查器交互式地测试服务器。这允许您检查工具和资源,并直接进行工具调用。

  1. 先构建项目:

    npm run build
    
  2. 使用以下命令运行检查器 npx,将其指向您构建的服务器脚本:

    npx @modelcontextprotocol/inspector node dist/index.js
    

    注意:在Windows上,如果遇到问题,请使用完整路径或确保有效的路径语法。

  3. 打开终端中提供的URL(通常 http://localhost:5173)与您的服务器进行交互。

直接运行

您可以直接运行服务器(它通过Stdio通信),但它是为MCP客户端(如Claude Desktop或Inspector)使用而设计的。

npm start

开发中

在开发模式下运行服务器(使用 tsx):

npm run dev

使用Claude Desktop进行设置

要将此服务器与Claude Desktop应用程序一起使用,请执行以下操作:

  1. 找到您的Claude Desktop配置文件:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户: %APPDATA%\Claude\claude_desktop_config.json
  2. 添加服务器配置:

    {
      "mcpServers": {
        "coingecko_price": {
          "command": "node",
          "args": ["/absolute/path/to/mcp_coingecko_price_ts/dist/index.js"]
        }
      }
    }
    

    记得跑 npm run build 在对源代码进行更改之后。

  3. 您可以使用npx命令通过stdio传输运行此mcp

    {
     "mcpServers": {
       "coingecko_price": {
         "command": "npx",
         "args": ["-y", "mcp_coingecko_price_ts"]
       }
     }
    }