mcp-all-in-one

MCP server dạng modular monolith để kết nối nhiều provider qua một gateway có permission, policy, secret boundary, output sanitization và audit thống nhất.

Server hiện chạy MCP qua stdio và có các provider:

• Redash: implementation hoàn chỉnh để đọc query metadata, cached results, refresh/poll query results, query allowlist và giới hạn output.
• PostgreSQL: scaffold metadata/tool policy; adapter database vẫn là TODO.
• GitHub: scaffold read-only tools; adapter API vẫn là TODO.

Chạy nhanh với Redash và Docker

cp .env.example .env
# Sửa REDASH_URL, REDASH_API_KEY, REDASH_QUERY_ALLOWLIST trong .env
docker compose build
docker compose run --rm -T mcp-server

Lệnh cuối là MCP stdio process nên sẽ chờ JSON-RPC trên stdin, không in menu interactive. Bình thường MCP client sẽ start process này.

Chạy native

npm ci
npm run typecheck
npm test
npm run build

export REDASH_URL=https://redash.example.com
export REDASH_API_KEY=your-key
export REDASH_QUERY_ALLOWLIST=123,456
npm start

Tài liệu

• Setup server và cấu hình MCP clients
• Redash provider
• Configuration
• Provider development
• Architecture
• Security model

Kiểm tra

npm run typecheck
npm test
npm run build

Config và secret tuân theo nguyên tắc: YAML chỉ chứa *_ref; secret thật được resolve server-side và không được trả về MCP result, log hoặc audit record.