JEB MCP

A Model Context Protocol (MCP) server for JEB reverse engineering platform. This server enables AI assistants like Claude to interact with JEB through the standardized MCP protocol.

Installation

npm install @xi0yu/jebmcp

Quick Start

Claude Desktop Configuration

To use this with Claude Desktop, add the following to your claude_desktop_config.json:

Windows: %APPDATA%/Claude/claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "jeb": {
      "command": "npx",
      "args": ["-y", "@xi0yu/jebmcp"]
    }
  }
}

VS Code Configuration

Add the following to your VS Code User Settings (JSON) by pressing Ctrl + Shift + P and typing "Preferences: Open User Settings (JSON)":

{
  "mcp": {
    "servers": {
      "jeb": {
        "command": "npx",
        "args": ["-y", "@xi0yu/jebmcp"]
      }
    }
  }
}

Alternatively, create a .vscode/mcp.json file in your workspace:

{
  "servers": {
    "jeb": {
      "command": "npx",
      "args": ["-y", "@xi0yu/jebmcp"]
    }
  }
}

Usage

Basic Usage

npx @xi0yu/jebmcp

Transport Modes

# STDIO mode (default)
npx @xi0yu/jebmcp --transport stdio

# HTTP mode
npx @xi0yu/jebmcp --transport http --port 16162

# SSE mode  
npx @xi0yu/jebmcp --transport sse --port 16162

Custom JEB Connection

npx @xi0yu/jebmcp --jeb-host 127.0.0.1 --jeb-port 16161 --jeb-path /mcp

Configuration

Environment Variables

You can configure the proxy using environment variables:

{
  "mcpServers": {
    "jeb": {
      "command": "npx",
      "args": ["-y", "@xi0yu/jebmcp"],
      "env": {
        "JEB_HOST": "127.0.0.1",
        "JEB_PORT": "16161",
        "LOG_ENABLED": "true"
      }
    }
  }
}

Available Environment Variables

• JEB_HOST: JEB server host (default: 127.0.0.1)
• JEB_PORT: JEB server port (default: 16161)
• JEB_PATH: JEB MCP endpoint path (default: /mcp)
• LOG_ENABLED: Enable detailed logging (default: false)

Requirements

• Node.js: Version 16.0.0 or higher
• Python: Version 3.8 or higher
• JEB: JEB reverse engineering platform with MCP support

Troubleshooting

Node.js Version Requirements

Problem: Error message: Cannot find module 'node:path'

Solution: Upgrade your Node.js installation to version 18 or later. Make sure the command in config points to the correct Node.js version.

Python Not Found

Problem: python3: command not found or similar Python-related errors

Solution:

1. Ensure Python is installed and available in your PATH
2. Install required Python dependencies: pip install fastmcp>=0.1.0
3. On Windows, the proxy automatically detects whether to use python or python3

Connection Issues

Problem: Unable to connect to JEB server

Solution:

1. Ensure JEB is running and MCP server is enabled
2. Verify the JEB MCP server is listening on the correct host and port
3. Check firewall settings if connecting to a remote JEB instance

Logging and Debug

Enable detailed logging by setting the LOG_ENABLED environment variable:

{
  "mcpServers": {
    "jeb": {
      "command": "npx",
      "args": ["-y", "@xi0yu/jebmcp"],
      "env": {
        "LOG_ENABLED": "true"
      }
    }
  }
}

Development

Building from Source

git clone https://github.com/xi0yu/jeb-mcp.git
cd jeb-mcp-npm
npm install
pip install -r requirements.txt

Testing

# Test the proxy
npm test

# Manual testing
node bin/index.js --help

License

Apache-2.0

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Related Projects

• Model Context Protocol - The official MCP specification
• FastMCP - Python SDK for MCP servers
• JetBrains MCP Proxy - Similar proxy for JetBrains IDEs