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