Crypto Whitepapers MCP 服务器

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

功能

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

前提条件

• Python 3.10+
• uv 用于依赖管理及运行
• 互联网访问。
• Claude Desktop 用于MCP集成（可选）

设置

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中运行“分析以太坊的代币经济学。”

示例

1. 列出可用项目：

   列出所有可用项目。
   

2. 搜索白皮书：

   搜索比特币白皮书PDF。
   

3. 加载白皮书：

   从https://bitcoin.org/bitcoin.pdf加载比特币白皮书。
   

4. 查询知识库：

   向知识库询问关于比特币白皮书中区块链技术的信息。
   

许可证

本项目采用MIT许可证。有关详细信息，请参阅LICENSE文件。