6amdev-server-mcp

6AMDev MCP Server

MCP (Model Context Protocol) Server สำหรับจัดการ Ubuntu Server พร้อม AI Integration

Features

• System Management: ดู CPU, RAM, Disk, Processes, Logs
• Docker Control: จัดการ containers (start, stop, logs, exec)
• Gitea Integration: จัดการ Git repositories และ Issues
• Ollama Tools: ควบคุม Local LLM models
• Workspace Management: จัดการไฟล์และโปรเจกต์
• Claude Code Integration: AI-powered coding assistant

Architecture

┌─────────────────┐     MCP Protocol      ┌─────────────────────────────────┐
│  Windows PC     │◄────────────────────► │  Ubuntu Server (192.168.80.203) │
│  (Cursor/Claude)│     (stdio)           │                                 │
└─────────────────┘                       │  ┌─────────────────────────────┐│
                                          │  │  MCP Server (Node.js)       ││
                                          │  │  - System Tools             ││
                                          │  │  - Docker Tools             ││
                                          │  │  - Gitea Tools              ││
                                          │  │  - Ollama Tools             ││
                                          │  │  - Workspace Tools          ││
                                          │  │  - Claude Code Tools        ││
                                          │  └─────────────────────────────┘│
                                          └─────────────────────────────────┘

Quick Start

1. Clone Repository

cd ~/workspace
git clone http://192.168.80.203:3000/wit/6amdev-mcp-server.git
cd 6amdev-mcp-server

2. Install Dependencies

npm install

3. Configure Environment

cp .env.example .env
nano .env  # Edit with your values

4. Install Claude Code (Optional)

chmod +x scripts/install-claude-code.sh
./scripts/install-claude-code.sh

5. Build & Run

npm run build
npm start

6. Setup as Systemd Service (Optional)

chmod +x scripts/setup-systemd.sh
sudo ./scripts/setup-systemd.sh

Client Configuration

Cursor / Claude Desktop

Add to your MCP configuration file:

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

{
  "mcpServers": {
    "6amdev": {
      "command": "ssh",
      "args": ["-tt", "wit@192.168.80.203", "cd ~/workspace/6amdev-mcp-server && node dist/index.js"]
    }
  }
}

Available Tools

System Tools

| Tool | Description | |------|-------------| | system_status | ดูสถานะ CPU, RAM, Disk | | system_processes | ดู process ที่ทำงานอยู่ | | system_logs | ดู system logs | | system_uptime | ดู uptime และ load |

Docker Tools

| Tool | Description | |------|-------------| | docker_list | แสดง containers ทั้งหมด | | docker_start | Start container | | docker_stop | Stop container | | docker_restart | Restart container | | docker_logs | ดู container logs | | docker_exec | รัน command ใน container | | docker_stats | ดูสถิติ resource usage | | docker_images | แสดง images |

Gitea Tools

| Tool | Description | |------|-------------| | gitea_repos | List repositories | | gitea_repo_info | ดูข้อมูล repository | | gitea_issues | List/manage issues | | gitea_create_issue | สร้าง issue ใหม่ | | gitea_branches | List branches |

Ollama Tools

| Tool | Description | |------|-------------| | ollama_list | แสดง models ที่มี | | ollama_status | ดูสถานะ Ollama service | | ollama_run | รัน prompt กับ model | | ollama_pull | Download model ใหม่ | | ollama_info | ดูข้อมูล model | | ollama_delete | ลบ model |

Workspace Tools

| Tool | Description | |------|-------------| | workspace_list | List projects | | workspace_tree | แสดงโครงสร้างโปรเจกต์ | | workspace_read | อ่านไฟล์ | | workspace_write | เขียนไฟล์ | | workspace_search | ค้นหาไฟล์/content | | workspace_git | รัน git commands |

Claude Code Tools

| Tool | Description | |------|-------------| | claude_ask | ถามคำถาม Claude Code | | claude_task | สั่งให้ทำ task | | claude_review | Review code | | claude_explain | อธิบายโค้ด | | claude_status | เช็คสถานะ Claude Code |

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | WORKSPACE_ROOT | Root directory for workspace | /home/wit/workspace | | GITEA_URL | Gitea server URL | http://localhost:3000 | | GITEA_TOKEN | Gitea API token | - | | OLLAMA_URL | Ollama API URL | http://localhost:11434 | | ANTHROPIC_API_KEY | Claude API key | - | | LOG_LEVEL | Logging level | info |

Development

# Run in development mode (auto-reload)
npm run dev

# Build
npm run build

# Lint
npm run lint

License

MIT © 6AMDev