Claude Agent

An MCP (Model Context Protocol) server that wraps the Claude Agent SDK. It uses Claude Code's built-in OAuth authentication, so no API key is required — just claude login and you're ready to go.

Features

Prerequisites

• Bun v1.0+
• Claude Code CLI installed and logged in (claude login)

Installation

git clone https://github.com/j-token/claude-agent-mcp.git
cd claude-agent-mcp
bun install

Usage

Run directly

bun start

Add to Claude Code as an MCP server

Add the following to your Claude Code MCP settings (~/.claude/settings.json):

{
  "mcpServers": {
    "claude-agent": {
      "command": "bun",
      "args": ["run", "/path/to/claude-agent-mcp/src/index.ts"]
    }
  }
}

Add to Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "claude-agent": {
      "command": "bun",
      "args": ["run", "/path/to/claude-agent-mcp/src/index.ts"]
    }
  }
}

Tools

claude_query

Send a prompt to Claude without any tools. Best for reasoning, text generation, and Q&A.

claude_code_task

Perform coding tasks with file system access. Can read, write, edit, and search files.

claude_web_search

Search the web and get a summarized result.

claude_multi_turn

Fully customizable agent execution. Configure every aspect of the agent run.

How It Works

┌─────────────┐     stdio      ┌───────────────────┐     OAuth     ┌─────────────┐
│  MCP Client │ ◄────────────► │ claude-agent-mcp  │ ◄───────────► │  Claude API  │
│ (Claude Code │                │  (this server)    │               │             │
│  / Desktop)  │                └───────────────────┘               └─────────────┘
└─────────────┘

1. An MCP client (Claude Code, Claude Desktop, etc.) connects to this server via stdio.
2. The client calls one of the registered tools (claude_query, claude_code_task, etc.).
3. This server delegates the request to the Claude Agent SDK, which uses your existing OAuth session.
4. The response is streamed back and returned to the client.

Development

# Type-check
bun run typecheck

# Build
bun run build

License

MIT