Repolode
nicobailon

nicobailon/pi-mcp-adapter

유휴 도구 정의로 컨텍스트 창이 가득 차지 않도록, 하나의 프록시 도구를 통해 Pi 코딩 에이전트가 MCP 서버를 사용하게 해 주는 어댑터입니다.

스타
1,644
포크
393
열린 이슈
0
마지막 커밋
어제

어떤 프로젝트인가요?

pi-mcp-adapter는 Pi 코딩 에이전트를 Model Context Protocol (MCP) 서버에 연결합니다. 모든 도구 정의를 모델의 컨텍스트에 불러오는 대신, 약 200토큰 규모의 프록시 도구 하나를 제공하며 에이전트는 필요할 때 도구를 검색하고 호출합니다.

서버는 기본적으로 지연 실행됩니다. 처음 호출될 때 시작되고, 10분 동안 유휴 상태이면 종료됩니다. 어댑터는 .mcp.json 같은 표준 MCP 설정 파일을 읽으며 Cursor, Claude Code, Codex, VS Code의 서버 설정을 가져올 수 있습니다. stdio, streamable HTTP, legacy SSE, rmcp-mux 전송 방식과 OS 키체인에 토큰을 저장하는 OAuth 로그인, MCP 프롬프트, elicitation, sampling, Tasks를 지원합니다.

이 프로젝트는 npm으로 설치하는 TypeScript 확장 프로그램이며, Pi 0.99 이상을 대상으로 합니다. Pi 세션에서 Pi의 내장 MCP 지원을 대체합니다.

핵심 기능

  • 01모든 MCP 도구 정의를 컨텍스트에 불러오는 대신 프록시 도구 하나를 제공합니다
  • 02서버를 지연 실행하고 10분 동안 유휴 상태이면 종료합니다
  • 03Cursor, Claude Code, Codex, VS Code에서 서버 설정을 가져옵니다
  • 04stdio, streamable HTTP, legacy SSE, rmcp-mux 전송 방식을 지원합니다
  • 05OAuth 토큰을 OS 키체인에 저장합니다
  • 06System One 키를 사용한 선택적 시맨틱 도구 검색을 지원합니다

활용 사례

  • 컨텍스트를 불필요하게 늘리지 않으면서 MCP를 통해 코딩 에이전트에 데이터베이스, 브라우저, API 접근 권한을 제공합니다
  • 실제로 사용하는 MCP 서버에만 비용을 지불하면서 여러 서버를 설치합니다
  • Cursor나 Claude Code에 이미 설정한 MCP 서버 구성을 재사용합니다

빠른 시작

  1. 1

    어댑터를 Pi에 설치합니다

    pi install npm:pi-mcp-adapter
  2. 2

    설치 후 Pi를 다시 시작합니다

  3. 3

    프로젝트의 .mcp.json에 서버를 추가합니다(README 예시 참조)

사용 전 알아둘 점

  • Pi 코딩 에이전트에서만 작동하며, 독립형 MCP 클라이언트로는 사용할 수 없습니다.
  • 시맨틱 도구 검색에는 System One 키가 필요합니다. 단어 검색과 정규식 검색은 키 없이 사용할 수 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

pi-mcp-adapter은(는) 무엇인가요?
유휴 도구 정의로 컨텍스트 창이 가득 차지 않도록, 하나의 프록시 도구를 통해 Pi 코딩 에이전트가 MCP 서버를 사용하게 해 주는 어댑터입니다. pi-mcp-adapter는 Pi 코딩 에이전트를 Model Context Protocol (MCP) 서버에 연결합니다. 모든 도구 정의를 모델의 컨텍스트에 불러오는 대신, 약 200토큰 규모의 프록시 도구 하나를 제공하며 에이전트는 필요할 때 도구를 검색하고 호출합니다.
pi-mcp-adapter은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
pi-mcp-adapter은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
pi-mcp-adapter은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. pi-mcp-adapter의 마지막 커밋은 2026년 11월 6일입니다.
pi-mcp-adapter은(는) 어디에 사용할 수 있나요?
컨텍스트를 불필요하게 늘리지 않으면서 MCP를 통해 코딩 에이전트에 데이터베이스, 브라우저, API 접근 권한을 제공합니다 실제로 사용하는 MCP 서버에만 비용을 지불하면서 여러 서버를 설치합니다 Cursor나 Claude Code에 이미 설정한 MCP 서버 구성을 재사용합니다
pi-mcp-adapter는 어떻게 설치하나요?
어댑터를 Pi에 설치합니다: pi install npm:pi-mcp-adapter 설치 후 Pi를 다시 시작합니다 프로젝트의 .mcp.json에 서버를 추가합니다(README 예시 참조)
pi-mcp-adapter은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/nicobailon/pi-mcp-adapter

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트