MCP Crypto Client-Server Implementation Guide

MCP 加密货币客户端-服务端实现指南

本指南将帮助你设置 Model Context Protocol（MCP）服务和客户端，以便使用 CoinGecko API 获取加密货币数据。

概述

系统由以下部分组成：

1. Python MCP 服务：处理 CoinGecko 的 API 请求，并通过 MCP 工具提供功能
2. TypeScript MCP 客户端：连接到服务，并提供与服务端工具交互的方法
3. React 前端：用于与加密货币数据交互的网页界面

服务端设置

前提条件

• Python 3.9+
• pip

安装

1. 创建虚拟环境：

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

2. 安装依赖项：

   pip install starlette uvicorn httpx mcp-server python-dotenv
   

3. 在项目根目录中创建 .env 文件：

   COINGECKO_API_KEY=your_api_key  # Optional, free tier can work without it
   PORT=8000
   

4. 将 Python 服务端代码保存到 server.py

5. 启动服务：

   python server.py --port 8000 --debug
   

   你可以通过命令行参数自定义主机和端口：

   python server.py --host 127.0.0.1 --port 8080
   

服务将在 http://localhost:8000 上运行。

自定义实现

添加新工具

要向服务端添加新工具：

1. 使用 @mcp_app.tool() 装饰器创建一个新函数
2. 实现该函数，以从 CoinGecko 获取数据或处理现有数据
3. 向 TypeScript 客户端添加相应的方法
4. 更新 React UI 以使用新功能