🤖 MCP — AI 에이전트 연결

Router Port Manager는 Model Context Protocol (2025-03-26) 위에서 AI 에이전트가 공유기 정보를 조회·조작할 수 있는 도구들을 노출합니다.

상태: 활성

엔드포인트

POST http://rpm.k-sw.org/mcp

인증: HTTP 헤더 Authorization: Bearer <MCP_TOKEN>

제공 도구 (Tools)

전체 목록은 tools/list JSON-RPC 호출로 받습니다. 요약:

이름	설명
list_regions	모든 지역 목록
list_routers	공유기 목록 (region_id로 필터 가능)
get_router_details	한 공유기 상세 (비밀번호 제외)
list_port_forwards	해당 공유기의 포트포워딩 규칙 (DB 캐시)
crawl_port_forwards	장비 직접 크롤링 후 캐시 갱신
test_router_connection	도달성 + 인증 테스트
get_status	전체 카운트/통합 상태

curl 테스트

curl -X POST http://rpm.k-sw.org/mcp \
  -H 'Authorization: Bearer $MCP_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq

Claude Desktop 설정 (참고)

Claude Desktop의 claude_desktop_config.json 에 추가:

{
  "mcpServers": {
    "router-port-manager": {
      "url": "http://rpm.k-sw.org/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer "
      }
    }
  }
}

참고

Claude Desktop은 HTTP transport를 직접 지원하지 않을 수 있습니다. 그 경우 mcp-remote 등의 어댑터로 stdio→HTTP 변환을 거쳐 연결하세요.

예시 — 한 공유기의 규칙 가져오기

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_port_forwards",
    "arguments": { "router_id": "<router-uuid>" }
  }
}