How do I use mcp-commands?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-commands show me my recent command history and usage stats" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcp-commands

MCP server สำหรับติดตามการใช้งาน AI commands

เก็บข้อมูลว่าใช้ command อะไรบ้าง เมื่อไหร่ และบริบทใดบ้าง โดยใช้ PostgreSQL เป็น storage

Architecture

Private Server (Docker Compose)
├── mcp-commands-db      ← PostgreSQL 16
└── mcp-commands-server  ← SSE mode, port 8432

Claude Code (ทุก machine)
└── url: "http://your-server:8432/sse"   ← ไม่ต้อง install อะไรเพิ่ม

ไม่ต้องแยก server กับ client — codebase เดียวรองรับทั้งสองโหมดผ่าน MCP_TRANSPORT

Option A: Central Server (แนะนำ)

Deploy บน private server

git clone https://github.com/PuemMTH/mcp-commands
cd mcp-commands
cp .env.example .env          # แก้ POSTGRES_PASSWORD
docker compose up -d

เพิ่มใน Claude Code (~/.claude.json) — ทุก machine

{
  "mcpServers": {
    "mcp-commands": {
      "url": "http://your-server:8432/sse"
    }
  }
}

ข้อมูลทุก session เก็บรวมใน Postgres เดียวกัน

Option B: รัน Local ด้วย uvx

สำหรับคนที่อยากรัน instance ของตัวเองแบบ stdio (ต้องมี PostgreSQL อยู่แล้ว)

# ตั้ง DATABASE_URL ให้ชี้ไป Postgres ของตัวเอง
DATABASE_URL=postgresql://user:pass@localhost:5432/mcp_commands \
  uvx --from git+https://github.com/PuemMTH/mcp-commands mcp-commands

เพิ่มใน Claude Code (~/.claude.json):

{
  "mcpServers": {
    "mcp-commands": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/PuemMTH/mcp-commands", "mcp-commands"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost:5432/mcp_commands"
      }
    }
  }
}

MCP Tools

Tool	คำอธิบาย
`log_command_tool`	บันทึก command ที่ใช้งาน
`get_history_tool`	ดูประวัติการใช้งาน
`get_stats_tool`	สถิติสรุปการใช้งาน
`search_commands_tool`	ค้นหา command ในประวัติ
`delete_command_tool`	ลบ record ด้วย id

ตัวอย่างการใช้งาน

log_command_tool(command="/recap",         category="session",  context="morning standup")
log_command_tool(command="/commit",        category="git")
log_command_tool(command="deep-research",  category="research", context="MCP protocol study")

get_history_tool(limit=10)
get_stats_tool()
search_commands_tool(query="git")

Environment Variables

Variable	Default	คำอธิบาย
`DATABASE_URL`	`postgresql://mcp_commands:mcp_commands@localhost:5432/mcp_commands`	PostgreSQL DSN
`MCP_TRANSPORT`	`stdio`	`stdio` หรือ `sse`
`MCP_PORT`	`8432`	Port สำหรับ SSE mode

Categories แนะนำ

Category	คำอธิบาย
`git`	git related commands
`session`	session management
`research`	research tools
`oracle`	oracle commands
`code`	coding tools
`skill`	Claude Code skills