convez.ai
MCP ServerFinanceiroIntermediário
kukapay

Crypto Whitepapers MCP

kukapay/crypto-whitepapers-mcp

Base de conhecimento de whitepapers crypto para agentes IA analisarem

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que funciona como base de conhecimento estruturada de whitepapers de criptmoedas. Permite buscar, carregar e consultar PDFs de whitepapers via ferramentas integradas ao Claude, com suporte a filtros por projeto.

Instalação

$npx convez-ai kukapay/crypto-whitepapers-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
7
Forks
8
Acompanhando
1
Saúde
42%
Último commit
há 1 ano
Versão
—
Issues abertas
2
Contribuidores
1

Casos de uso

  • Análise de tokenomics e mecanismos econômicos de projetos cripto
  • Pesquisa técnica sobre protocolos e arquiteturas blockchain
  • Comparação de características entre diferentes criptomoedas

Veredito

Ferramenta bem implementada para pesquisa técnica em crypto, mas limitada a um nicho específico. Útil para quem trabalha com análise de projetos blockchain, mas requer integração manual e conhecimento prévio de whitepapers relevantes.

README

A tradução para o português deste README ainda está na fila.

Crypto Whitepapers MCP Server

An MCP server serving as a structured knowledge base of crypto whitepapers for AI agents to access, analyze, and learn from.

Discord GitHub License Python Version Status

Features

  • Search Whitepapers: Use DuckDuckGo to find whitepaper PDFs for cryptocurrency projects.
  • Load Whitepapers: Download and index whitepaper PDFs into the knowledge base.
  • Query Knowledge Base: Query whitepaper content with optional project filtering.
  • List Projects: View all projects available in the knowledge base.
  • Claude Desktop Integration: Access tools and prompts via MCP in Claude Desktop.

Prerequisites

  • Python 3.10+
  • uv for dependency management and running
  • Internet access.
  • Claude Desktop for MCP integration (optional)

Setup

  1. Clone the Repository:

    git clone https://github.com/kukapay/crypto-whitepapers-mcp.git
    cd crypto-whitepapers-mcp
    
  2. Install Dependencies with uv:

    uv sync
    
  3. Integrate with Claude Desktop (Optional):

    • Edit the Claude Desktop configuration file:
      • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
      • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Add the following configuration:
      {
          "mcpServers": {
              "crypto-whitepapers": {
                  "command": "uv",
                  "args": [
                      "--directory",
                      "/absolute/path/to/crypto-whitepapers-mcp"   
                      "run",
                      "crypto-whitepapers-mcp"
                  ]
              }
          }
      }
      
      Replace /absolute/path/to/crypto-whitepapers-mcp with the absolute path to the repository.
    • Restart Claude Desktop and verify the server is loaded (look for the hammer icon in the input box).

Usage

Tools

The following tools are available via the MCP server:

  • list_available_projects(): Lists all projects in the knowledge base (derived from PDF filenames).

    • Example: list_available_projects()
    • Returns: JSON list of project names.
  • search_whitepaper(project_name: str): Searches for a project's whitepaper PDF using DuckDuckGo.

    • Example: search_whitepaper("bitcoin")
    • Returns: JSON list of up to 5 results with title, URL, and snippet.
  • load_whitepaper(project_name: str, url: str): Downloads a whitepaper PDF from a URL and loads it into the knowledge base.

    • Example: load_whitepaper("bitcoin", "https://bitcoin.org/bitcoin.pdf")
    • Returns: Success or error message.
  • ask_whitepapers(query: str, project_name: str = None): Searches the knowledge base for a query, optionally filtered by project.

    • Example: ask_whitepapers("blockchain technology", "bitcoin")
    • Returns: Up to 5 matching text snippets.

Prompts

  • analyze_tokenomics(project_name: str): Analyzes tokenomics (distribution, supply, incentives) in a project's whitepaper using the ask_whitepapers tool.
    • Example: In Claude Desktop, run "Analyze the tokenomics of Ethereum."

Examples

  1. List available projects:
    List all available projects.
    
  2. Search for a whitepaper:
    Search for the Bitcoin whitepaper PDF.
    
  3. Load a whitepaper:
    Load the Bitcoin whitepaper from https://bitcoin.org/bitcoin.pdf.
    
  4. Query the knowledge base:
    Ask the knowledge base about blockchain technology in the Bitcoin whitepaper.
    

License

This project is licensed under the MIT License. See the LICENSE file for details.

Ver o original no GitHub

Bom para

Relacionados