https://claude.ai/chat/4dea4e6a-4f62-44b0-8a96-f87167a17fef https://claude.ai/public/artifacts/8f2db72a-f062-4d0c-b64c-e7f4018910d6

cloudflared tunnel --url http://localhost:3001

• 이메일: test@example.com

• 비밀번호: password123

PocketBase 작업 MCP 서버

작업 및 프로젝트를 관리하기 위해 PocketBase와 통합되는 MCP(Model Context Protocol) 서버입니다. 이 서버를 통해 AI 모델(예: Claude)은 작업을 생성하고, 상태 필터를 사용하여 작업을 나열하며, 프로젝트를 탐색할 수 있습니다.

이제 HTTP를 통해 실행됩니다 - 로컬에서 테스트하기 쉽고 배포 준비가 완료되었습니다!

기능

• HTTP 전송: 복잡한 설정 없이 간단한 URL 기반 액세스 가능

• 도구 체이닝: 먼저 ID를 가져와 작업을 프로젝트에 자동으로 연결

• 프로젝트 관리: projects 컬렉션에서 모든 프로젝트 나열

• 작업 관리: 필수 프로젝트 관계를 포함하여 task 컬렉션에 작업 생성

• 상태 필터링: '대기 중(Pending)' 또는 '완료됨(Completed)' 상태별로 작업 나열

• 환경 기반: PocketBase 인증을 위해 .env 파일을 통해 안전하게 관리

• 쉬운 테스트: 간단한 상태 확인 엔드포인트 및 MCP Inspector 지원

⚡ 빠른 시작

# 1. Install dependencies
npm install

# 2. Create .env file
echo "PB_AUTH_TOKEN=your_super_admin_token_here" > .env

# 3. Build the project
npm run build

# 4. Start the server
node dist/index.js

이제 서버가 http://localhost:3000에서 실행 중입니다!

테스트: 브라우저에서 http://localhost:3000/health를 엽니다.

🚀 시작하기

1. 사전 요구 사항

• Node.js (v18+)

• http://127.0.0.1:8090에서 로컬로 실행 중인 PocketBase

• PocketBase 슈퍼 관리자 토큰.

2. 설치

npm install

3. 구성

프로젝트 루트에 .env 파일을 생성합니다:

PB_AUTH_TOKEN=your_super_admin_token_here

🛠️ 개발 및 디버깅

프로젝트 빌드

TypeScript 코드를 JavaScript로 컴파일합니다:

npm run build

HTTP 서버 시작

로컬에서 서버를 실행합니다:

node dist/index.js

서버가 http://localhost:3000(또는 .env 파일에 지정된 포트)에서 시작됩니다.

다음과 같은 출력이 표시되어야 합니다:

MCP server running on http://localhost:3000
Health check: http://localhost:3000/health
MCP endpoint: http://localhost:3000/mcp

서버 테스트

브라우저에서 상태 확인 엔드포인트를 방문합니다:

http://localhost:3000/health

다음이 표시되어야 합니다:

{"status":"ok","message":"PMS MCP Server is running"}

선택적 포트 구성

포트를 변경하려면 .env 파일에 추가하세요:

PORT=3000
PB_AUTH_TOKEN=your_super_admin_token_here

📖 사용 가능한 도구

• list_projects: 모든 프로젝트와 해당 ID를 가져옵니다.

• create_task: 새 작업을 생성합니다(task_title, eta, status, project_id 필요).

• list_tasks: 선택적 상태 필터링을 사용하여 모든 작업을 나열합니다.

🧪 도구 테스트

MCP Inspector를 사용하거나 http://localhost:3000/mcp의 HTTP 엔드포인트를 통해 연결하여 MCP 서버를 테스트할 수 있습니다.

MCP Inspector 사용

npx @modelcontextprotocol/inspector

그런 다음 http://localhost:3000/mcp에 연결합니다.

🌐 왜 Stdio 대신 HTTP인가?

장점:

• 구성 파일 없음: claude_desktop_config.json이나 기타 복잡한 설정을 편집할 필요가 없음

• 쉬운 테스트: 브라우저나 Postman 같은 도구를 통한 간단한 URL 액세스

• 원격 준비 완료: 서버에 배포하여 어디서나 액세스 가능

• 다중 클라이언트: 여러 애플리케이션이 동시에 연결 가능

• 더 나은 디버깅: 표준 HTTP 도구로 요청 및 응답을 쉽게 모니터링 가능

MCP 클라이언트에서 연결:

MCP 호환 클라이언트를 사용할 때 다음 주소로 연결하세요:

http://localhost:3000/mcp

📝 종속성

• @modelcontextprotocol/sdk: 핵심 MCP 기능

• pocketbase: PocketBase JS SDK

• express: HTTP 서버 프레임워크

• cors: 교차 출처 리소스 공유 미들웨어

• zod: 스키마 유효성 검사

• dotenv: 환경 변수 관리