关键词

加密货币数据市场行情Coinmarket API资源访问工具调用

Coinmarket MCP 服务器使用说明

项目简介

Coinmarket MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在将 Coinmarket API 提供的加密货币市场数据以标准化的方式提供给支持 MCP 协议的 LLM 客户端，例如 Claude。该服务器实现了资源的托管和管理，并提供了工具的注册和执行能力，使得 LLM 能够方便地获取最新的加密货币列表和报价信息。

主要功能点

  • 资源 (Resources):
    • 提供最新的加密货币列表 (coinmarket://cryptocurrency/listings)。
    • 提供加密货币报价信息 (coinmarket://cryptocurrency/quotes)，支持通过 'slug' (如 bitcoin) 或 'symbol' (如 BTC) 查询。
  • 工具 (Tools):
    • 'get_currency_listings': 获取最新的加密货币列表。
    • 'get_quotes': 获取加密货币报价信息，可以指定 'slug' 或 'symbol' 作为参数。

安装步骤

本服务器通常无需单独安装，因为它被设计为由 MCP 客户端（如 Claude）启动和管理。您需要确保您的 MCP 客户端支持自定义服务器配置，并按照客户端的指示添加本服务器的配置信息。

服务器配置

要将 Coinmarket MCP 服务器添加到 MCP 客户端，您需要配置服务器的启动命令和相关参数。以下是 Claude Desktop 客户端的配置示例，您需要将此配置添加到 Claude 的 'claude_desktop_config.json' 文件中。

配置信息 (JSON 格式):

{
  "server name": "coinmarket_service",
  "command": "uv",
  "args": [
    "--directory",
    "/path/to/coinmarket_mcp_server",  // 请替换为 coinmarket-mcp-server 仓库的实际路径
    "run",
    "coinmarket_service"
  ],
  "env": {
    "COINMARKET_API_KEY": "<your_coinmarket_api_key>" // 请替换为您的 Coinmarket API 密钥
  }
}

参数注释:

  • 'server name': 服务器的名称，例如 'coinmarket_service'，在客户端中用于标识该服务器。
  • 'command': 启动服务器的命令，这里使用 'uv'，你需要确保你的环境中安装了 'uv' (一个 Python 打包和运行工具，你可能需要先安装它，例如 'pip install uv')。如果你的项目使用了其他运行方式，请相应修改此命令。
  • 'args': 传递给 'command' 的参数列表。
    • '--directory': 指定服务器代码所在的目录，请务必将其替换为 'coinmarket-mcp-server' 仓库在您本地文件系统中的实际路径。
    • 'run': 指示 'uv' 运行指定的 Python 包。
    • 'coinmarket_service': 要运行的 Python 包的名称，对应于仓库中的 'src/coinmarket_service' 目录。
  • 'env': 环境变量设置。
    • 'COINMARKET_API_KEY': 请务必将其替换为您从 Coinmarket 获得的 API 密钥。这是访问 Coinmarket API 的凭证。

请注意:

  • 你需要先从 Coinmarket 官网获取 API 密钥才能使用此服务器。
  • 你需要根据你的实际环境和 'coinmarket-mcp-server' 仓库的存放位置，修改配置信息中的路径和 API 密钥。
  • 如果你的 MCP 客户端不是 Claude Desktop，请参考客户端的文档，找到添加自定义 MCP 服务器配置的方法，并根据上述信息进行配置。

基本使用方法

配置完成后，当 MCP 客户端连接到 Coinmarket MCP 服务器后，LLM 就可以通过以下方式使用服务器提供的功能：

  1. 访问资源: LLM 可以请求读取 'coinmarket://cryptocurrency/listings' 或 'coinmarket://cryptocurrency/quotes' 资源来获取加密货币数据。对于 'quotes' 资源，可以在 URI 中添加查询参数，例如 'coinmarket://cryptocurrency/quotes?slug=bitcoin' 或 'coinmarket://cryptocurrency/quotes?symbol=BTC'。

  2. 调用工具: LLM 可以调用 'get_currency_listings' 工具来获取最新的加密货币列表，或调用 'get_quotes' 工具来获取加密货币报价。调用 'get_quotes' 工具时，可以提供 'slug' 或 'symbol' 参数。

具体的资源访问和工具调用方式取决于 MCP 客户端的功能和用户界面。请参考您使用的 MCP 客户端的文档来了解如何利用配置的 MCP 服务器。

信息

分类

网页与API

访问项目