crypto-funds-mcp 是一个 MCP(模型上下文协议)服务器,旨在为 AI 智能体提供结构化、实时的加密货币投资基金数据,帮助实现更深入的尽职调查和投资组合情报。
主要能力
该服务器提供以下数据访问工具:
- get_all_funds():获取所有投资者和基金的完整列表。
- search_funds(tier, type, sortBy, sortDirection, limit, skip):支持按层级、类型筛选基金,并可按指定字段排序、分页。
- get_fund_basic(fund_id):获取指定基金的基本指标,如层级、投资组合规模、ROI 等。
- get_fund_full(fund_id):获取综合指标,包括投资重点、近期轮次和阶段。
- get_fund_team(fund_id):获取团队详细信息,包含角色和社交链接。
技术特性
- 格式化输出:所有响应以 ASCII 表格形式返回,便于在 MCP 客户端中阅读。
- 异步 API 调用:使用 httpx 进行高效的异步 HTTP 请求。
- 环境配置:通过 .env 文件结合 dotenv 管理 API 密钥。
- 错误处理:优雅地处理 API 错误和缺失数据。
使用方式
前置要求
- uv:Python 包和虚拟环境管理器(推荐用于依赖管理)。
- 一个 Cryptorank API 密钥(在 Cryptorank 注册获取)。
安装步骤
- 克隆仓库: git clone https://github.com/kukapay/crypto-funds-mcp.git cd crypto-funds-mcp
- 安装依赖: uv sync
- 在根目录创建 .env 文件并添加 API 密钥: CRYPTORANK_API_KEY=your_api_key_here
安装到 Claude Desktop
将服务器安装为 Claude Desktop 应用: uv run mcp install main.py --name "Crypto Funds"
配置文件参考: { "mcpServers": { "Crypto Funds": { "command": "uv", "args": ["--directory", "/path/to/crypto-funds-mcp", "run", "main.py"], "env": { "CRYPTORANK_API_KEY": "cryptorank_api_key" } } } } 请将 /path/to/crypto-funds-mcp 替换为实际安装路径,将 cryptorank_api_key 替换为你的 Cryptorank API 密钥。
工具使用示例
以下为各工具示例,包含自然语言提示、对应的工具调用及示例结果(格式为 ASCII 表格)。实际结果取决于 Cryptorank API 密钥及当前数据。
- 显示所有加密货币投资者和基金的完整列表。
- 搜索 Tier 1 Venture 基金,按零售 ROI 降序排序,显示前 100 条结果。
- 获取 ID 为 1 的基金的基本指标,例如层级、投资组合和 ROI。
- 提供 ID 为 2 的基金的综合数据和投资详情。
- ID 为 3 的基金团队成员有哪些?包括他们的角色和社交链接。
许可证
本项目采用 MIT 许可证,详见 LICENSE 文件。