Web3 Research MCP

给我们点个赞 ❤️ →        

由本地运行的 MCP 服务提供加密货币深度研究。
搜索和数据请求会发送给相应的外部提供方，页面抓取工具会访问提供的 URL。研究状态和已保存资源存储在本地；公共来源无需 API 密钥。

## 🚀 预览

🧠 功能

• 全面研究：收集有关任意加密货币代币的详细信息
• 多来源分析：综合 CoinGecko、CoinMarketCap、DeFiLlama 等多个来源开展研究
• 结构化报告：生成详细报告，涵盖技术基本面、市场数据、社交情绪等
• 资源管理：自动保存搜索结果和内容，供日后参考
• 状态跟踪：跟踪研究在不同阶段和部分中的进度

📋 要求

• Node.js 18 或更高版本

🔧 安装与设置

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 web3-research-mcp：

npx -y @smithery/cli install web3-research-mcp --client claude

🔌 在 Claude Desktop 中使用

编辑 Claude Desktop 配置文件

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

将以下内容添加到 Claude Desktop 配置文件中：

{
  "mcpServers": {
    "web3-research-mcp": {
      "command": "npx",
      "args": ["-y", "web3-research-mcp@latest"]
    }
  }
}

然后重启 Claude Desktop

🔌 在 Claude Code 中使用

claude mcp add web3-research-mcp -- npx -y web3-research-mcp@latest

🔌 在 Cursor 中使用

前往：Settings -> Cursor Settings -> MCP -> Add new global MCP server 将以下内容粘贴到 Cursor 的 ~/.cursor/mcp.json 文件中。更多信息请参阅 Cursor MCP 文档。

{
  "mcpServers": {
    "web3-research-mcp": {
      "command": "npx",
      "args": ["-y", "web3-research-mcp@latest"]
    }
  }
}

然后重启 Cursor

🧩 从源代码运行

git clone https://github.com/aaronjmars/web3-research-mcp.git
cd web3-research-mcp
npm ci
npm run build
npm start   # MCP server over stdio

若要让客户端连接到本地构建版本，请使用 "command": "node" 和 "args": ["/path/to/web3-research-mcp/dist/server.js"]。

⚙️ 配置

无需 API 密钥。可选的环境变量：

• COINGECKO_API_KEY：CoinGecko Pro 密钥。未设置时，将使用免费公共 API。

🛠️ 工具

create-research-plan

为代币创建结构化研究计划。

参数：

• tokenName：代币的全名
• tokenTicker：代币的代码

search

执行网络搜索并返回结果。

参数：

• query：搜索查询
• searchType：搜索类型（网页、新闻、图片、视频）

research-with-keywords

使用指定关键词搜索代币并保存结果。

参数：

• tokenName：代币名称
• tokenTicker：代币代码
• keywords：要搜索的关键词数组

update-status

更新研究部分的状态。

参数：

• section：要更新的部分名称（例如，projectInfo、technicalFundamentals）
• status：该部分的新状态（planned、in_progress、completed）

fetch-content

从 URL 获取内容并将其保存为资源。

参数：

• url：要获取内容的 URL
• format：输出格式（text、html、markdown、json）

list-resources

列出所有已保存的可用资源。

search-source

从指定来源搜索代币相关信息。

参数：

• tokenName：代币名称
• tokenTicker：代币代码
• source：要搜索的来源（例如，CoinGecko、DeFiLlama、News）

research-source

搜索指定来源中的代币信息，并将排名第一的结果页面内容保存为 Markdown 资源。

参数：

• tokenName：代币名称
• tokenTicker：代币代码
• source：要研究的来源（例如，IQ Wiki、CoinMarketCap）

coingecko-data

直接从 CoinGecko 公共 API 获取实时市场数据：价格、市值、24h/7d/30d 涨跌幅、ATH/ATL、流通供应量、各链上的合约地址，以及社交媒体和开发者链接。避免了 HTML 抓取遇到的 403 问题。

参数：

• tokenName：代币全名（例如，Bitcoin）
• tokenTicker：代币代码（例如，BTC）

无需 API 密钥。使用免费公共层（约 30 次请求/分钟）。

可选：在环境中设置 COINGECKO_API_KEY，以使用 CoinGecko Pro API 密钥。设置后，请求将发送至 https://pro-api.coingecko.com/api/v3，并附带 x-cg-pro-api-key 标头。请求超时时间为 15s。

coingecko-search

搜索 CoinGecko 的币种索引，并返回包含 CoinGecko ID 的候选匹配项。当代币代码存在歧义时（例如，多个代币使用相同代码），此工具很有用。

参数：

• query：搜索查询：名称、代币代码或合约地址

coingecko-tickers

从 CoinGecko 获取代币的活跃交易所挂牌信息：哪些 CEX/DEX 交易该交易对、各交易场所的 24h USD 交易量、最新价格、买卖价差、信任评分和交易 URL。按 24h USD 交易量降序排列，并过滤异常数据和过时行情。无需 HTML 抓取，即可回答“该代币实际上在哪里交易”这一常见问题。

参数：

• tokenName：代币全名（例如，Bitcoin）
• tokenTicker：代币代码（例如，BTC）
• limit：返回的头部交易场所数量（默认 15，最多 50）

无需 API 密钥。使用免费公共层。请求超时时间为 15s。

defillama-data

直接从 DeFiLlama 公共 API 获取协议数据：TVL 总额、ATH TVL 及日期、30/90/365 天 TVL 相对当前值的变化、市值（如果有；DeFiLlama 的许多协议数据中不包含市值）、各链 TVL 明细、手续费（24h/7d/30d/累计）、代币地址、融资轮次和链接。无需 HTML 抓取，即可查询最常见的 DeFi 协议信息。

参数：

• tokenName：协议/代币全名（例如，Uniswap）
• tokenTicker：代币代码（例如，UNI）

无需 API 密钥。使用免费公共 API。请求超时时间为 15s。协议索引会在每个进程中缓存 5 分钟，避免每次调用都频繁请求 /protocols。

defillama-search

搜索 DeFiLlama 的协议索引，并返回包含 slug、TVL 和类别的候选匹配项。当代币代码存在歧义时（例如，多个协议名称相似），此工具很有用。

参数：

• query：搜索查询：协议名称、代币代码或 slug

📝 提示词

token-research

对加密货币代币启动全面研究。

参数：

• tokenName：加密货币代币全名
• tokenTicker：代币代码（例如，BTC、ETH）

🧠 工作原理

1. 开始研究时，会创建一份涵盖代币各个方面的结构化计划
2. 服务会从多个来源搜索信息
3. 搜索结果会保存为可供引用的资源
4. 研究会逐步推进不同章节，并跟踪状态
5. 生成一份涵盖代币各个方面的综合报告

⚠️ 限制

• 某些网站会阻止网页抓取，因此直接获取内容可能会返回 403 错误
• 依赖搜索结果，而搜索结果可能并不全面
• 搜索操作可能会受到速率限制

📄 许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

---

由 Aeon 和 MiroShark 创始人 Aaron Elijah Mars 构建 · @aaronjmars