🪙 使用 ALPACA API 的 MCP 加密货币价格查询服务器

本项目搭建了一个加密货币价格查询服务，由 ALPACA API 提供支持，并构建用于与 MCP (多代理控制协议) 集成。

该服务器允许 AI 代理或客户端使用 Alpaca 的 API 有效地获取实时加密货币价格和市场数据。

---

📦 步骤 1：使用 uv 设置环境

我们将使用 uv — 一个快速、现代的 Python 包管理器 — 来创建和管理项目环境。

🛠️ 安装与设置

在您的终端中（而不是在 Jupyter 中）运行以下命令：

# 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh 

# 创建并导航到您的项目目录
mkdir mcp-crypto-server
cd mcp-crypto-server

# 初始化一个新项目
uv init

# 创建并激活虚拟环境
uv venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

# 安装所需的依赖项
uv add "mcp[cli]" httpx

步骤 2：运行 MCP 服务器

环境设置完成后，我们就可以构建和运行我们的加密货币价格查询工具了。 从 scripts 文件夹复制服务器脚本：

cp ../mcp_server.py .

启动 MCP 服务器：
uv run mcp_server.py

💡 查看 mcp_server.py，了解该工具如何与 Alpaca API 交互的实现细节。

关于服务器

与 MCP 兼容的服务器包括以下工具：

• 获取实时加密货币价格（例如，BTC/USD、ETH/USD）
• 使用 Alpaca 的 REST API 访问市场数据
• 为 AI 代理提供快速、格式化的响应

步骤 3：配置您的 MCP 服务器

将以下内容添加到您的 MCP 配置以注册服务器：

{
    "mcpServers": {
        "crypto-price-tracker": {
            "command": "/ABSOLUTE/PATH/TO/uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/GenAI_Agents//mcp-crypto-server",
                "run",
                "mcp_server.py"
            ]
        }
    }
}

🔁 将 /ABSOLUTE/PATH/TO/... 替换为您的 uv 二进制文件和项目文件夹的完整路径。

步骤 4：重启 Claude Desktop 以使更改生效。

步骤 5：尝试询问比特币的价格

• 您可以将自己的工具添加到 mcp_server.py

"""
This script demonstrates how to create a simple MCP server that fetches
the current price of a cryptocurrency using the CoinGecko API.
It uses the FastMCP library to create the server and handle requests.
"""
import httpx
from dotenv import load_dotenv
from mcp.server.fastmcp import FastMCP

load_dotenv()

COINGECKO_BASE_URL = "https://api.coingecko.com/api/v3"

# Create our MCP server with a descriptive name
mcp = FastMCP("crypto_price_tracker")

# Now let's define our first tool - getting the current price of a cryptocurrency
@mcp.tool()
async def get_crypto_price(crypto_id: str, currency: str = "usd") -> str:
    """
    Get the current price of a cryptocurrency in a specified currency.
    
    Parameters:
    - crypto_id: The ID of the cryptocurrency (e.g., 'bitcoin', 'ethereum')
    - currency: The currency to display the price in (default: 'usd')
    
    Returns:
    - Current price information as a formatted string
    """
    # Construct the API URL
    url = f"{COINGECKO_BASE_URL}/simple/price"
    
    # Set up the query parameters
    params = {
        "ids": crypto_id,
        "vs_currencies": currency
    }
    
    try:
        # Make the API call
        async with httpx.AsyncClient() as client:
            response = await client.get(url, params=params)
            response.raise_for_status()  # Raise an exception for HTTP errors
            
            # Parse the response
            data = response.json()
            
            # Check if we got data for the requested crypto
            if crypto_id not in data:
                return f"Cryptocurrency '{crypto_id}' not found. Please check the ID and try again."
            
            # Format and return the price information
            price = data[crypto_id][currency]
            return f"The current price of {crypto_id} is {price} {currency.upper()}"
            
    except httpx.HTTPStatusError as e:
        return f"API Error: {e.response.status_code} - {e.response.text}"
    except Exception as e:
        return f"Error fetching price data: {str(e)}"

# You can add more tools here, following the same pattern as above

# Run the MCP server
# This will start the server and listen for incoming requests
if __name__ == "__main__":
    mcp.run()

---

📈 更进一步：构建 yFinance 股票服务器

一旦您熟悉了流程，就可以继续构建这个更高级的股票追踪器 💹

🔗 GitHub 仓库： https://github.com/Adity-star/mcp-yfinance-server

📝 详细博客： 👉 我如何使用 Python、yFinance 和一点书呆子野心构建自己的股票服务器

享受学习的乐趣！