使用说明
项目简介
该项目是一个 MCP (Model Context Protocol) 服务器,旨在为大型语言模型 (LLM) 应用提供访问 Coinmarket API 加密货币市场数据的能力。通过该服务器,LLM 可以获取最新的加密货币列表和特定加密货币的实时行情数据。
主要功能点
- 资源 (Resources): 提供加密货币列表和行情数据资源,允许 LLM 客户端通过标准 URI 访问。
- 工具 (Tools): 注册 'get-currency-listings' 和 'get-quotes' 两个工具,允许 LLM 客户端调用以获取加密货币数据。
- 配置: 需要 Coinmarket API 密钥才能正常运行。
安装步骤
- 确保已安装 Python 和 pip。
- 克隆该 GitHub 仓库到本地。
- 进入仓库目录。
- (可选,如果需要本地开发)创建一个虚拟环境并激活。
- 安装项目依赖 (虽然仓库中没有 'requirements.txt' 或 'pyproject.toml',但假设需要安装 'mcp-server' 和 'python-dotenv' 以及 'requests',用户需要自行安装):
pip install mcp-server python-dotenv requests - 设置 Coinmarket API 密钥环境变量 'COINMARKETCAP_API_KEY'。可以将密钥添加到 '.env' 文件或直接设置到系统环境变量中。
服务器配置
以下 JSON 配置信息用于 MCP 客户端(例如 Claude Desktop)连接到此 MCP 服务器。请根据实际情况修改 'command' 和 'args' 中的路径。
{ "server_name": "coinmarket_service", // 服务器名称,客户端用于识别 "command": "uv", // 启动服务器的命令,这里假设使用 uv (or python) 运行 "args": [ // 启动命令的参数 "--directory", // 指定工作目录 "/path/to/anjor_coinmarket-mcp-server/src", // 替换为你的仓库 src 目录的绝对路径 "run", // 使用 uv run (or python -m) 运行模块 "coinmarket_service" // 要运行的 Python 模块名 ], "env": { // 环境变量 "COINMARKET_API_KEY": "<your_coinmarket_api_key>" // 替换为你的 Coinmarket API 密钥 } }
基本使用方法
- 启动 MCP 服务器。根据上面的配置,在终端中执行配置中 'command' 和 'args' 对应的命令即可启动服务器。
- 在支持 MCP 协议的 LLM 客户端(例如 Claude Desktop)中,配置上述服务器配置信息。
- LLM 客户端将能够发现服务器提供的资源和工具,并可以使用自然语言指令调用这些功能,例如:
- "获取最新的加密货币列表" (可能会触发 'get_currency_listings' 工具)
- "查询比特币的行情" (可能会触发 'get_quotes' 工具,参数为 slug 或 symbol)
信息
分类
网页与API