Crypto Whitepapers MCP Server

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

功能

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

预备条件

• 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("区块链技术", "bitcoin")
  • 返回：最多5个匹配的文本片段。

提示

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

示例

1. 列出可用项目：

   列出所有可用项目。
   

2. 搜索白皮书：

   搜索比特币白皮书PDF。
   

3. 加载白皮书：

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

4. 查询知识库：

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

许可证

本项目根据MIT许可证发布。详情见LICENSE文件。