여러 코딩 에이전트를 위한 하의 로컬 MCP 진입점입니다. 구성된 업스트림 MCP 도구를 프록시하고, 업스트림 세션을 활성 상타로 유지하며, 독점 서비스에 대한 호출을 직렬화하고, 프로세스 리소스를 보고하며, SQLite 기반의 작은 업무, 자금, 메모리 도구를 노출합니다.
python -m pip install -e '.[dev]'
cp config.example.toml config.toml
mcp-gateway serve --config config.tomlMCP 클라인트를 다은에 연결하세요:
http://127.0.0.1:8000/mcpstdio만 지원하는 클라이언트는 게이트웨이 브리지 프로세스 하나를 실질할 수 있어습니다:
{
"command": "mcp-gateway",
"args": ["serve", "--config", "/absolute/path/config.toml", "--transport", "stdio"]
}Related MCP server: warmplane
[gateway]
host = "127.0.0.1"
port = 8000
database = "gateway.db"
auth_token_env = "MCP_GATEWAY_TOKEN"
[servers.example]
transport = "stdio"
command = "npx"
args = ["-y", "some-mcp-server"]
mode = "exclusive"
max_in_flight = 1
queue_limit = 32
[servers.remote]
transport = "streamable_http"
url = "http://127.0.0.1:9000/mcp"
mode = "pool"
max_connections = 2
queue_limit = 64업스트림 도구는 <server_id>__<tool_name> 형식으로 노출됩니다. 게이트웨이 조정 도구는 gateway__ 접두사를 사용합니다. per_agent는 v0.1에서 프로세스 단위로 한정됩니다. 별도 rite. M겠. 업데이트 세션을 원하면 어전트별로 stdio 브리지를 하나 실행하세요. 첫 버전은 도구만 프록시하며, 프로토콜·리소스, 프럼, 챔플처럼, 분산 예약은 차기 계획입니다.
mcp-gateway status
mcp-gateway start example
mcp-gateway stop example
mcp-gateway restart example관리자 API는 기반적으로 프백 전용입니다:
GET /health
GET /v1/status
POST /v1/servers/{id}/start
POST /v1/servers/{id}/stop
POST /v1/servers/{id}/restart토큰 환경 변수를 설정하면 MCP 및 관리 HTTP 요청에 Authorization: Bearer ... 가 필요합니다. 명령과 인자는 TOML로만 받고, 에이전트의 모든 셸 문자열은 실행하지 않습니다.
게이트웨이가 제공하는 gateway__* 도구에서는: 작업 임대, 낙관적 작업 업데이트, 리소스 잠금, 프로젝트 속성 메모리.
SQLite는 WAL 모드와 짧은 트랜잭션을 사용하며, 잠금과 임대는 만료됩니다. 즉 연결이 끊긴 에이전트가 작업을 무기한 붙들지 못합니다.
로컬 저장소에는 자격 인증, 원본 대화, 프로덕션 데이터를 넣지 마세요.
python -m pytest -q
python -m compileall -q universal_mcp_gateway
git diff --check더 자세한 기여(G contract)와 남은 작업은 SPEC.md와 tasks/plan.md를 참고하세요.
This server cannot be deployed
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Hosted MCP server for task-first delegation to remote workstations and workers.
Private-by-default, local-first memory/context/task orchestrator for MCP apps and agents.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
