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

6amdev-server-mcp