MCPServer + CoinGecko Wrapper

MCPServer + CoinGecko Wrapper

此仓库包含两个用于处理 Model Context Protocol (MCP) 的关键组件：

---

1. mcpserver (PHP)

主服务，用于接收并响应来自兼容 Agent 的 MCP 请求。

主要文件：

• core/：可复用的核心逻辑。
• capabilities.php：声明此服务可使用哪些工具（tools）。
• webhook.php：接收 MCP 请求的主要端点。

它的作用是什么？

• 接收 MCP 格式的请求（JSON）。
• 根据 tool_choice 在内部进行路由。
• 调用相应的工具（例如 CoinGecko wrapper）。
• 返回结构化的 MCP 响应，供 Agent 处理。

---

2. mcp-coingecko-wrapper (Node.js + TypeScript)

通过 CoinGecko 公共 API 提供加密货币数据的外部工具。

结构：

• src/index.ts：wrapper 的主要逻辑。
• package.json：脚本和依赖项。

它的作用是什么？

• 提供兼容 MCP 的 HTTP 端点。
• 支持获取以下数据：
  • 加密货币的当前价格。
  • 基本信息。
  • 价格历史记录。

---

两者如何协同工作？

1. Agent（如 Claude 或 GPT）发起 MCP 查询。
2. mcpserver 的 webhook.php 接收请求并决定使用哪个工具。
3. 如果查询涉及加密货币，则调用 TypeScript wrapper（mcp-coingecko-wrapper）。
4. 获取 CoinGecko 的响应并以 MCP 格式返回。

---

要求

• PHP 8+，并支持 curl（用于 mcpserver）。
• Node.js 18+（用于 wrapper）。
• 兼容 MCP 的 Agent 实例（例如：Claude）。

---

快速安装

# 1. Instalar dependencias del wrapper
cd mcp-coingecko-wrapper
npm install
npm run build

# 2. Servir el mcpserver (PHP)
# Usar XAMPP, Apache o cualquier servidor PHP con acceso a webhook.php

---

馃摤 MCP 请求示例

{
  "tool_choice": "coingecko",
  "input": {
    "symbol": "bitcoin",
    "operation": "price_now"
  }
}

---

完成。连接 Agent 与 CoinGecko 并使用 MCP 所需的一切都在这里。