pathguard-mcp

MCP 호환 AI 에이전트가 PathGuard를 사용하여 대화 중에 암호화폐 거래의 사기와 실수를 직접 확인할 수 있게 해 줍니다. Claude Desktop, Claude Code, Gemini CLI, Grok CLI, Cursor, Codex 같은 로컬 MCP 클라이언트는 물론, ChatGPT 및 Grok 웹 커넥터용 원격 Streamable HTTP 배포도 지원합니다.

무료 플랜을 포함한 모든 요금제에서 사용할 수 있습니다. 이 패키지는 다른 모든 항목과 동일한 인증 API 엔드포인트를 호출하므로, 기존 API 키의 할당량이 그대로 적용됩니다.

설치

pip install pathguard-mcp

(아직 PyPI에 게시되지 않았으므로 이 폴더에서 소스로 직접 설치하세요: pip install -e .)

mcp >= 2.0이 필요합니다. 이 패키지는 현재 MCP SDK 기준으로 빌드 및 테스트되었습니다. 이전 FastMCP API를 사용하는 구버전을 쓰고 있다면 먼저 업그레이드하고(pip install --upgrade mcp) 사용하세요. 그렇지 않으면 작동하지 않습니다.

API 키 받기

키가 없다면 pathguard.cieltech.org/docs.html에서 무료로 가입하세요.

로컬 MCP 클라이언트 구성

이 패키지를 클라이언트가 실행되는 곳에 설치한 다음, 서버에 PathGuard API 키를 지정하세요. 아래 예시는 설치된 pathguard-mcp 명령을 사용합니다. PATH에 없다면 설치된 전체 실행 파일 경로로 바꿔 사용하세요.

Claude Desktop

Claude Desktop 설정(claude_desktop_config.json)에 다음 항목을 추가하세요:

{
  "mcpServers": {
    "pathguard": {
      "command": "pathguard-mcp",
      "env": {
        "PATHGUARD_API_KEY": "pg_your_key_here"
      }
    }
  }
}

Claude Desktop을 다시 시작하면 Claude가 PathGuard의 도구를 자동으로 사용할 수 있습니다.

Claude Code

claude mcp add --transport stdio pathguard -- \
  pathguard-mcp

PATHGUARD_API_KEY를 Claude Code를 시작하는 환경 변수로 설정하세요. 또는 Claude Code의 MCP 구성에서 해당 변수를 명시적으로 전달할 수도 있습니다.

Gemini CLI

사용자 전역으로 설정하려면 ~/.gemini/settings.json에, 프로젝트별로 설정하려면 .gemini/settings.json에 다음 항목을 추가하세요:

{
  "mcpServers": {
    "pathguard": {
      "command": "pathguard-mcp",
      "env": {
        "PATHGUARD_API_KEY": "pg_your_key_here"
      }
    }
  }
}

또는 키를 내보낸 뒤 명령줄에서 추가할 수도 있습니다:

export PATHGUARD_API_KEY=pg_your_key_here
gemini mcp add --scope user pathguard pathguard-mcp

Grok CLI

키를 내보낸 뒤 로컬 stdio 서버를 추가하세요:

export PATHGUARD_API_KEY=pg_your_key_here
grok mcp add pathguard -- pathguard-mcp

구성을 ~/.grok/config.toml에 직접 저장하려면 다음을 사용하세요:

[mcp_servers.pathguard]
command = "pathguard-mcp"
env = { PATHGUARD_API_KEY = "${PATHGUARD_API_KEY}" }

Codex, Cursor, VS Code 및 기타 로컬 MCP 클라이언트

Claude Desktop 예시와 동일한 stdio 서버 정을 사하세요: 명령 pathguard-mcp, 인자 없음, 그리고 환경 변수에 PATHGUARD_API_KET. 정확한 설정 화일 위차나 UI는 클라이언트마다 다를 수 있지만 MCP 서버 설정 자체는 동일합니다.

원격 클라이언트 구성: ChatGPT 및 Grok 웹

ChatGPT와 Grok의 브라우저 기반 커스텀 커넥터는 컴퓨터에서 로컬 명령을 직접 실행할 수 없습니다. PathGuard MCP를 Streamable HTTP로 배포하고 HTTPS 뒤에 둔 다음, 커넥터 UI에 공개 엔드포인트를 입력하세요.

로컬 또는 배포 환경에서 HTTP 서버를 시작하세요:

export PATHGUARD_API_KEY=pg_your_key_here
pathguard-mcp --transport streamable-http --host 0.0.0.0 --port 8000 \
  --allowed-host mcp.example.com

MCP 엔드포인트는 http://<host>:8000/mcp입니다. ChatGPT 또는 Grok 웹의 경우 https://mcp.example.com/mcp처럼 보호된 HTTPS URL로 공개하고, 브라우저나 저장소에 API 키가 그대로 노출되지 않게 하세요. 호스트 이름은 --allowed-host 옵션으로 전달하거나 PATHGUARD_MCP_ALLOWED_HOSTS=mcp.example.com으로 설정해, 서버가 공개 도메인을 통한 요청을 안전하게 수락할 수 있게 하세요. 이 서버의 PathGuard 자격 증명은 서버 측에 있으므로, 각 배포 인스턴스는 해당 서버의 PATHGUARD_API_KEY에 연결된 PathGuard 계정을 나타냅니다.

ChatGPT

Developer Mode가 활성화된 ChatGPT 워크스페이스에서 커스텀 MCP 앱을 만들고, 공개 https://.../mcp 엔드포인트를 제공한 뒤 도구를 스캔하고 워크스페이스에 맞게 저장/게시하세요. ChatGPT는 로컬 stdio 명령이 아닌 원격 MCP 서버에만 연결됩니다. 현재 지원 요금제와 설정 방법은 OpenAI의 Developer Mode 및 MCP 앱 가이드를 참고하세요.

Grok 웹

grok.com/connectors에서 New Connector를 선택한 뒤 Custom을 선택하고 공개 https://.../mcp 엔드포인트를 입력하세요. Grok은 공용 인터넷을 통해 서버에 연결할 수 있어야 합니다. 현재 커넥터 흐름은 xAI의 커스텀 MCP 커넥터 가이드에서 확인하세요.

배포 참고 사항

• 새 원격 구축에는 Streamable HTTP를 쓰세요. 이것이 현재 MCP의 HTTP 전송 방식입니다.

• TLS는 호스팅 플랫폼이나 리버스 프록시에서 종료하고, 가능하면 접근을 신뢰할 수 있는 사용자 또는 게이트웨이로 제한하세요. 현재 이 서버는 설정된 API 키 하나로 PathGuard에 인증하며, 개별 MCP 사용자 자체를 인증하지 않습니다.

• 배포 플랫폼에 더 잘 맞다면 명령줄 플래그 대신 PATHGUARD_MCP_TRANSPORT=streamable-http, PATHGUARD_MCP_HOST=0.0.0.0, PATHGUARD_MCP_PORT=8000, PATHGUARD_MCP_ALLOWED_HOSTS=mcp.example.com을 설정해도 됩니다. PATHGUARD_MCP_PORT가 설정되지 않으면 PORT 변수도 인식됩니다.

• 데스크톱 및 CLI 클라이언트에는 기본 stdio 전송을 유지하세요.

사용 가능한 도구

로컬 테스트하기

프로덕션 대신 로컬 백엔드를 지정해 주세요:

export PATHGUARD_API_KEY=pg_your_test_key
export PATHGUARD_API_BASE=http://localhost:8000
pathguard-mcp

전체 API 참조

전체 엔드포인트 문서, 요청 제한, 플래그 의미는 pathguard.cieltech.org/docs.html에서 확인하세요. 이 MCP 서버는 같은 API를 단순하게 감싸는 얇은 래퍼입니다.