claude-code-mcp Project MCP Server

@KunihiroS

Repository Homepage

Basic information

About claude-code-mcp Project MCP Server

MCP Server connects with claude code local command.

#mcp #claude #anthropic #anthropic-claude #model-context-protocol #mcp-server #claude-code

claude-code-mcp Project MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "claude-code-mcp": {
      "command": "npx",
      "args": [
        "@kunihiros/claude-code-mcp"
      ]
    }
  }
}

claude-code-mcp Project MCP Server tools

Provides a detailed explanation of the given code.

Reviews the given code.

Fixes bugs or issues in the given code.

Edits the given code based on instructions.

Generates tests for the given code.

Simulates the execution of a given command.

Sends a custom query with context.

Overview

What is claude-code-mcp?

claude-code-mcp is an MCP server that calls the locally installed Claude Code CLI and provides tools for code explanation, review, fixing, editing, testing, command simulation, and custom queries. It communicates via stdio and uses Base64 encoding to handle special characters in natural language text.

How to use claude-code-mcp?

Run the server via npx @kunihiros/claude-code-mcp or install globally with npm install -g claude-code-mcp and run claude-code-mcp. Set the required CLAUDE_BIN environment variable to the path of your Claude CLI executable. Configuration can be provided through MCP host settings, a .env file, or a global ~/.claude-code-mcp.env file.

Key features of claude-code-mcp

Provides seven tools: explain_code, review_code, fix_code, edit_code, test_code, simulate_command, and your_own_query
Base64 encodes natural language input for stable processing
Communicates via stdio using JSON‑formatted requests and responses
Configurable log level (debug, info, warn, error)
Supports running from MCP hosts like Claude Desktop (unconfirmed)

Use cases of claude-code-mcp

Explain or review code using Claude Code from any MCP‑compatible host
Automatically fix bugs or edit code with natural language instructions
Generate unit tests for existing code
Simulate command execution before running it
Send custom queries with optional context

Frequently asked questions

What are the runtime requirements?

Node.js 18 or later (tested with v22.14.0), npm (or yarn), and the Claude Code CLI installed and authenticated.

How do I set the path to the Claude CLI?

Set the `CLAUDE_BIN` environment variable (required) to the absolute path of your Claude executable, e.g. `/home/linuxbrew/.linuxbrew/bin/claude`.

What tools are available?

The server offers `explain_code`, `review_code`, `fix_code`, `edit_code`, `test_code`, `simulate_command`, and `your_own_query`.

Can I use claude-code-mcp with Claude Desktop?

The README notes that calling Claude Code from Claude Desktop may work, but this is unconfirmed.

Where are logs stored?

The log file `claude-code-mcp.log` is first created in the project root, then falls back to the user’s home directory (`~/.claude-code-mcp.log`), and finally to `/tmp/claude-code-mcp.log`. Log rotation is not implemented.

Comments

More AI & Agents MCP servers

Hostinger

hostinger

Model Context Protocol (MCP) server for Hostinger API. If you don't want to install or run anything locally, connect directly to Hostinger's hosted MCP server: This opens a browser window to authorize via OAuth. Once app

148

BlazingCDN MCP - Content Delivery for Video, Software & Static Files

BlazingCDN

Official MCP server for BlazingCDN - AI agents (Claude, Cursor, Windsurf) manage CDN resources, purge cache, query metrics, domains, Anycast CDN, Video CDN and Media CDN

OpenZiti MCP Gateway

openziti

NetFoundry MCP Gateway enables secure, isolated access to Model Context Protocol (MCP) tools across distributed systems without exposing public endpoints. Zero trust gateway for MCP servers. Aggregate, filter, and secure

Kourier

Kourier AI Inc.

Discover flat-rate DeepSeek plans, model limits, API-key instructions, and coding-client setup

Nova Data Analytics

nova-data-analytics

Amazon Seller Central MCP server. Connect Seller Central, Vendor Central and Amazon Ads to Claude, ChatGPT, Gemini or Cursor, and ask for net profit per SKU with your own COGS, VAT and FBM shipping costs, PPC down to the