Gooseworks MCP

Express 서버로, GitHub 도구 세트를 포함한 도구들을 Model Context Protocol (MCP) Streamable HTTP 전송 방식을 통해 노출합니다.

MCP 엔드포인트는 다음과 같습니다:

http://localhost:4000/mcp

모든 요청에는 MCP_AUTH_TOKEN으로 설정된 Bearer 토큰이 포함되어야 합니다.

요구 사항

• Node.js v25.2.1

• pnpm 11.5.3

• 컨테이너 배포를 위한 Docker Engine 및 Docker Compose v2

• 사용하려는 도구에 필요한 권한이 있는 GitHub 개인 액세스 토큰

Related MCP server: GitHub MCP Agent Server

설정

서버는 로컬 .env 파일 또는 프로세스 환경에서 변수를 로드합니다:

템플릿에서 로컬 환경 파일을 생성합니다:

cp .env.template .env

.env를 편집하고 두 개의 플레이스홀더 토큰 값을 교체합니다. MCP_AUTH_TOKEN에는 길고 무작위로 생성된 값을 사용하고, GitHub 토큰에는 이 서버에 필요한 권한만 부여합니다. .env를 커밋하거나 두 토큰 중 하나를 공개 이슈, 로그 또는 이미지에 붙여넣지 마십시오.

로컬에서 실행

1. 의존성 설치:

   pnpm install

2. 위에서 설명한 대로 .env를 생성하고 구성합니다.

3. 서버 시작:

   pnpm start

   이 명령은 pnpm exec tsx src/index.ts와 동일한 진입점을 실행합니다.

소스 변경 후 자동 재시작이 필요한 개발 환경에서는 다음을 사용하세요:

pnpm dev

파일을 생성하지 않고 TypeScript 프로젝트를 확인하려면:

pnpm typecheck

콘솔에서 http://localhost:<PORT>/mcp에서 활성화되었다고 보고하면 서버가 준비된 것입니다. MCP 클라이언트가 해당 URL을 사용하도록 구성하고 다음을 전송하세요:

Authorization: Bearer <MCP_AUTH_TOKEN>

Docker Compose로 배포

1. 호스트에 Docker Compose v2가 포함된 Docker Engine을 설치합니다.

2. 이 저장소를 클론하고 해당 디렉토리로 이동합니다:

   git clone <repository-url>
   cd gooseworks-mcp

3. 배포 환경 파일을 생성합니다:

   cp .env.template .env

4. .env에 GITHUB_TOKEN과 강력하고 비공개인 MCP_AUTH_TOKEN을 설정합니다. 서비스가 다른 호스트/컨테이너 포트에서 수신 대기해야 하는 경우 PORT를 설정합니다. Compose 포트 매핑의 양쪽에 동일한 값이 사용됩니다.

5. 백그라운드에서 서비스를 빌드하고 시작합니다:

   docker compose up --build -d

6. 서비스 로그를 확인하거나 필요할 때 중지합니다:

   docker compose logs -f gooseworks-mcp
   docker compose down

Compose 구성은 지원되는 세 가지 변수를 컨테이너에 전달하며, 필수 토큰 중 하나라도 누락되면 조기에 실패합니다. 공개 배포의 경우 서비스를 HTTPS 리버스 프록시 뒤에 배치하고 가능하면 포트 4000 또는 선택한 PORT를 비공개로 유지하세요. MCP 클라이언트는 프록시의 HTTPS /mcp URL과 구성된 Bearer 토큰을 사용해야 합니다.

사용 가능한 도구

서버는 다음 도구들을 등록합니다:

GitHub

• 인증된 프로필 읽기

• 저장소, 브랜치 및 커밋 목록 조회

• 코드 검색

• 파일 내용 읽기

• 이슈 생성

• 풀 리퀘스트 생성

라이선스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 라이선스 조건에 따라 모든 목적으로 자유롭게 사용, 포크, 수정 및 재배포할 수 있습니다.