Crypto Whitepapers MCP Server

加密货币白皮书 MCP 服务

一个 MCP 服务，作为加密货币白皮书的结构化知识库，供 AI Agent 访问、分析和学习。

功能

• 搜索白皮书：使用 DuckDuckGo 查找加密货币项目的白皮书 PDF。
• 加载白皮书：下载白皮书 PDF 并将其编入知识库索引。
• 查询知识库：查询白皮书内容，可选择按项目筛选。
• 列出项目：查看知识库中的所有可用项目。
• Claude Desktop 集成：通过 MCP 在 Claude Desktop 中使用工具和提示词。

前提条件

• Python 3.10+
• 用于依赖管理和运行的 uv
• 网络访问权限。
• 用于 MCP 集成的 Claude Desktop（可选）

设置

1. 克隆仓库：

   git clone https://github.com/kukapay/crypto-whitepapers-mcp.git
   cd crypto-whitepapers-mcp
   

2. 使用 uv 安装依赖：

   uv sync
   

3. 与 Claude Desktop 集成（可选）：

   • 编辑 Claude Desktop 配置文件：
     • MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
     • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • 添加以下配置：

     {
         "mcpServers": {
             "crypto-whitepapers": {
                 "command": "uv",
                 "args": [
                     "--directory",
                     "/absolute/path/to/crypto-whitepapers-mcp"   
                     "run",
                     "crypto-whitepapers-mcp"
                 ]
             }
         }
     }
     

     将 /absolute/path/to/crypto-whitepapers-mcp 替换为仓库的绝对路径。
   • 重启 Claude Desktop 并确认服务已加载（查看输入框中的锤子图标）。

使用方法

工具

以下工具可通过 MCP 服务使用：

• list_available_projects()：列出知识库中的所有项目（根据 PDF 文件名得出）。

  • 示例：list_available_projects()
  • 返回：项目名称的 JSON 列表。

• search_whitepaper(project_name: str)：使用 DuckDuckGo 搜索项目的白皮书 PDF。

  • 示例：search_whitepaper("bitcoin")
  • 返回：最多包含 5 条结果的 JSON 列表，其中含标题、URL 和摘要。

• load_whitepaper(project_name: str, url: str)：从 URL 下载白皮书 PDF 并将其载入知识库。

  • 示例：load_whitepaper("bitcoin", "https://bitcoin.org/bitcoin.pdf")
  • 返回：成功或错误消息。

• ask_whitepapers(query: str, project_name: str = None)：在知识库中搜索查询内容，可选择按项目筛选。

  • 示例：ask_whitepapers("blockchain technology", "bitcoin")
  • 返回：最多 5 条匹配的文本片段。

提示词

• analyze_tokenomics(project_name: str)：使用 ask_whitepapers 工具分析项目白皮书中的代币经济学（分配、供应量、激励机制）。
  • 示例：在 Claude Desktop 中运行“分析 Ethereum 的代币经济学。”

示例

1. 列出可用项目：

   List all available projects.
   

2. 搜索白皮书：

   Search for the Bitcoin whitepaper PDF.
   

3. 加载白皮书：

   Load the Bitcoin whitepaper from https://bitcoin.org/bitcoin.pdf.
   

4. 查询知识库：

   Ask the knowledge base about blockchain technology in the Bitcoin whitepaper.
   

许可证

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