# 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

```bash
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

```bash
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)

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

## Cấu hình Claude Desktop

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

Hoặc với tunnel URL:

```json
{
  "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) |