mcp-server

Overview

The BitDive MCP server exposes monitoring and QA operations to MCP clients like Cursor and Claude Desktop. It implements 23 tools for discovering active modules, fetching traces, reproducing requests, comparing traces before/after code changes, and managing test groups. The server adds important value beyond API proxying including trace readability formatting, comparison logic with normalized Java structures, and reproduction workflow helpers that generate curl/PowerShell commands.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_heatmap_all_system

  Get a compact heatmap summary for the entire system

  Try:Show me the system activity heatmapTry:Display heatmap for all modules
• get_heatmap_for_module

  Get a heatmap summary for a specific module

  Try:Show heatmap for the payment moduleTry:Display activity for auth module
• get_heatmap_for_service

  Get a heatmap summary for a specific service

  Try:Show heatmap for the user serviceTry:Display activity for order processing service
• get_last_calls

  Get the most recent system calls

  Try:Show me the last 10 callsTry:Display recent system activity
• find_trace_all

  Find traces across the entire system

  Try:Find traces related to payment failuresTry:Search for error traces in the system
• find_trace_for_method

  Find traces for a specific method

  Try:Find traces for the payment processing methodTry:Show traces for user authentication
• get_trace_names_batch

  Get trace names in batches

  Try:Get trace names from yesterdayTry:Show me trace names from the last hour
• get_reproduction_command

  Get reproduction commands for captured requests

  Try:Get curl command to reproduce that requestTry:Show how to replay that API call locally
• search_methods_short

  Search for methods with short information

  Try:Search for methods related to paymentTry:Find methods handling user authentication
• compare_traces

  Compare two traces to detect differences

  Try:Compare these two traces to see what changedTry:Show differences between trace A and B
• create_test_group

  Create a new test group in BitDive

  Try:Create a test group for payment flowsTry:Set up a test group for regression testing
• get_all_test_scripts

  Get all test scripts from BitDive

  Try:List all test scriptsTry:Show me all available test cases

Comparable tools

Installation

pip install -r requirements.txt

python server.py

MCP_TRANSPORT=streamable-http MCP_HOST=0.0.0.0 MCP_PORT=8000 python server.py

{
  "mcpServers": {
    "bitdive": {
      "command": "python",
      "args": [
        "/absolute/path/to/server.py"
      ],
      "env": {
        "BITDIVE_MCP_TOKEN": "your-token"
      }
    }
  }
}

FAQ

What does this server provide beyond the BitDive API?

It adds trace readability formatting, comparison logic with normalized Java structures, reproduction workflow helpers, and test management formatted for quick agent use instead of raw responses.

How do I configure authentication?

Set either the BITDIVE_MCP_TOKEN environment variable or pass mcp_token parameter directly to tools. The server requires a valid BitDive MCP token to function.

Compare mcp-server with