mcp-claudecode

MCP HTTP Server implementing 41 tools from Claude Code, built in Python.
Compatible với Claude Desktop, Cursor, và bất kỳ MCP client nào.

Tools (41 total)

Tool	Trạng thái	Mô tả
AgentTool	✅	Spawn sub-agent task
AskUserQuestionTool	✅	Hỏi user clarification
BashTool	✅ Full	Chạy shell commands
BriefTool	✅	Get/set context summary
ConfigTool	✅	Đọc/ghi config
EnterPlanModeTool	✅	Vào plan mode
EnterWorktreeTool	✅ Full	Vào git worktree
ExitPlanModeTool	✅	Thoát plan mode
ExitWorktreeTool	✅ Full	Thoát worktree
FileEditTool	✅ Full	Sửa file bằng string replacement
FileReadTool	✅ Full	Đọc file với pagination
FileWriteTool	✅ Full	Ghi/tạo file
GlobTool	✅ Full	Tìm file theo glob pattern
GrepTool	✅ Full	Tìm text bằng regex
LSPTool	🔶 Stub	Language Server Protocol
ListMcpResourcesTool	🔶 Stub	Liệt kê MCP resources
MCPTool	🔶 Stub	Gọi MCP tool
McpAuthTool	🔶 Stub	Auth MCP server
NotebookEditTool	✅ Full	Sửa Jupyter notebook
PowerShellTool	✅ Full	Chạy PowerShell
REPLTool	✅ Full	Interactive REPL (python/node)
ReadMcpResourceTool	🔶 Stub	Đọc MCP resource
RemoteTriggerTool	✅ Full	HTTP POST đến remote endpoint
ScheduleCronTool	✅	Tạo cron job (lưu JSON)
SendMessageTool	🔶 Stub	Gửi message đến session khác
SkillTool	🔶 Stub	Kích hoạt skill
SleepTool	✅ Full	Sleep/wait
SyntheticOutputTool	✅	Synthetic output
TaskCreateTool	✅ Full	Tạo task
TaskGetTool	✅ Full	Lấy info task
TaskListTool	✅ Full	Liệt kê tasks
TaskOutputTool	✅ Full	Set task output
TaskStopTool	✅ Full	Dừng task
TaskUpdateTool	✅ Full	Update task
TeamCreateTool	✅ Full	Tạo agent team
TeamDeleteTool	✅ Full	Xóa agent team
TodoWriteTool	✅ Full	Ghi todo list
ToolSearchTool	✅ Full	Tìm kiếm tool
WebFetchTool	✅ Full	Fetch URL
WebSearchTool	✅ Full	Web search (Brave/DuckDuckGo)
TestingPermissionTool	✅ Stub	Test permissions

Legend: ✅ Full = fully implemented | 🔶 Stub = returns metadata/placeholder

Cài đặt

cd mcp-claudecode
python -m venv .venv

# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate

pip install -r requirements.txt
playwright install chromium   # optional, dùng cho browser automation

Chạy server

python server.py

Server khởi động tại:

• MCP endpoint: http://localhost:3458/mcp
• Health check: http://localhost:3458/health

Expose qua Cloudflare Tunnel (optional)

python tunnel.py
# Public URL được lưu vào data/tunnel-url.txt

Cấu hình Claude Desktop

{
  "mcpServers": {
    "mcp-claudecode": {
      "url": "http://localhost:3458/mcp"
    }
  }
}

Hoặc với tunnel URL:

{
  "mcpServers": {
    "mcp-claudecode": {
      "url": "https://<your-tunnel>.trycloudflare.com/mcp"
    }
  }
}

Cấu trúc

mcp-claudecode/
├── server.py          # Main MCP server (41 tools)
├── tunnel.py          # Cloudflare Quick Tunnel helper
├── requirements.txt
├── tools/
│   ├── file_tools.py  # FileRead, FileWrite, FileEdit, Glob, Grep
│   ├── shell_tools.py # Bash, PowerShell, REPL
│   ├── web_tools.py   # WebFetch, WebSearch
│   ├── task_tools.py  # Task*, TodoWrite
│   ├── git_tools.py   # Worktree
│   ├── notebook_tool.py # NotebookEdit
│   └── agent_tools.py # Agent, Team, Config, Cron, MCP, LSP...
├── data/              # Runtime data (tasks.json, config.json, etc.)
└── workspace/         # Shared file workspace

Env vars

Var	Mô tả
MCP_PORT	Port (default: 3458)
BRAVE_API_KEY	Brave Search API key (optional, dùng cho WebSearchTool)