AI导哈

加密货币投资组合管理服务

一个集成了CoinGecko API和Civic Auth保护的加密货币投资组合管理服务，提供实时市场数据、投资组合管理和社交分享功能。

  • by civicteam
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 civicteam/coingecko-mcp-watchlist

使用说明

CoinGecko MCP观察列表服务器

一个安全的加密货币投资组合管理MCP服务器，集成了CoinGecko和Civic Auth保护，专为CoinGecko-MCP黑客马拉松而构建。

🎯 概述

该项目演示了如何构建一个全面的加密货币观察名单管理系统，该系统：

  • 保护API密钥 使用Civic Auth OAuth2.0保护昂贵的CoinGecko Pro API访问
  • 提供丰富的加密数据 通过无缝的CoinGecko API集成
  • 管理用户组合 有观察名单、价格跟踪和笔记
  • 启用社交功能 共享公共/私人观察名单
  • 实施MCP协议 用于AI代理与Claude、Cursor和其他LLM的集成

🛡️ 为什么公民认证API保护？

该服务器不是将您宝贵的CoinGecko Pro API密钥直接暴露给人工智能代理，而是作为一个安全代理：

  • API密钥保护：您的CoinGecko Pro API密钥保持在服务器端，从不暴露给客户
  • 用户认证：Civic Auth确保只有授权用户才能访问您的API资源
  • 成本控制：防止可能耗尽API配额的未经授权的使用
  • 访问日志记录：跟踪哪些用户正在进行哪些API调用

🚀 特性

  • 观察名单管理：创建、更新、删除加密货币观察列表
  • 实时价格：通过CoinGecko Pro API进行实时市场数据集成
  • 硬币发现：搜索趋势硬币和市场数据
  • 投资组合说明：为跟踪的硬币添加注释和目标价格
  • 社交分享：公共/私人观察名单可见性控制
  • 安全访问：Civic Auth保护API资源

先决条件

  • Node.js 18+
  • pnpm
  • CoinGecko Pro API密钥（可选-如果未提供，则返回公共API）

🔧 安装和设置

  1. 安装依赖项:
pnpm install
  1. 配置环境变量 （Pro API可选）： 创建一个 .env 文件或设置以下环境变量：
COINGECKO_PRO_API_KEY=your_actual_pro_api_key_here
COINGECKO_ENVIRONMENT=pro

备注：如果未提供API密钥，服务器将自动使用CoinGecko的具有共享速率限制的公共端点。

  1. 选择您的MCP配置:

选项A：安全代理（推荐）

将此服务器用作具有Civic Auth保护的安全代理：

{
  "mcpServers": {
    "coingecko_mcp_watchlist": {
      "type": "stdio",
      "command": "npx",
      "args": ["@civic/hub-bridge"],
      "env": {
        "MCP_REMOTE_URL": "http://localhost:3000/mcp",
        "COINGECKO_PRO_API_KEY": "YOUR_PRO_API_KEY_HERE",
        "COINGECKO_ENVIRONMENT": "pro"
      }
    }
  }
}

选项B：直接访问CoinGecko

对于没有安全代理层的直接访问：

{
  "mcpServers": {
    "coingecko_direct": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.api.coingecko.com/sse"
      ]
    }
  }
}

或者对于Pro API：

{
  "mcpServers": {
    "coingecko_pro_direct": {
      "command": "npx", 
      "args": [
        "mcp-remote",
        "https://mcp.pro-api.coingecko.com/sse"
      ]
    }
  }
}

🚀 运行服务器

pnpm dev

服务器将于启动http://localhost:3000

🧪 测试

使用 MCP检查员 要测试您的服务器：

npx @modelcontextprotocol/inspector

连接到 http://localhost:3000/mcp 使用“流式HTTP”传输。

🔐 API密钥安全

此服务器演示了一种用于保护有价值的API密钥的安全模式：

  • 服务器端存储：您的CoinGecko Pro API密钥安全存储在您的服务器上
  • 公民身份验证网关：所有请求首先通过Civic Auth身份验证
  • 代理模式：AI代理连接到您的安全服务器，而不是直接连接到CoinGecko
  • 使用控制：您对谁可以访问您的API配额保持完全控制

🏗️ 建筑

安全代理模式（推荐）

AI Agent (Claude/Cursor) → Civic Auth → Your MCP Server → CoinGecko API
                              ↓
                         User Authentication
                              ↓
                         Protected API Access

直接模式（备选）

AI Agent (Claude/Cursor) → CoinGecko MCP Server (Public/Pro)

为什么选择安全代理模式？

  • 🔐 API密钥保护
  • 👥 用户访问控制
  • 📊 使用情况分析
  • 💰 成本管理

📚 可用的MCP工具

  • create-watchlist -创建新的加密货币观察名单
  • get-my-watchlists -检索用户的监视列表
  • add-coin-to-watchlist -将加密货币添加到观察名单
  • get-watchlist-with-prices -获取实时市场数据的观察名单
  • search-coins - 搜索加密货币
  • get-trending-coins -获取加密货币趋势数据
  • 还有更多。..（请参阅完整的API源代码）

🎖️ 专为CoinGecko MCP黑客马拉松打造

该项目展示了：

  • 创新：人工智能代理的安全API密钥管理模式
  • 实用性：现实世界的加密货币投资组合管理需求
  • 整合：CoinGecko Pro API与MCP协议无缝集成

#建立CoinGecko |内置于❤️ 对于加密货币社区

相关 MCP