Freedcamp MCP 서버

Freedcamp 작업 관리를 위한 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. Freedcamp 프로젝트에서 작업을 생성, 업데이트 및 삭제하는 도구를 제공합니다.

특징

• 제목, 설명, 우선순위, 마감일 및 담당자를 지정하여 새 작업을 만듭니다.

• 상태 변경을 포함한 기존 작업 업데이트

• 작업 삭제

• 자격 증명에 대한 환경 변수 지원

• 오류 처리 및 검증

Related MCP server: Basecamp MCP Server

필수 조건

• Node.js 17 이상

• 타입스크립트

• API 액세스가 가능한 Freedcamp 계정

• Freedcamp의 API 키와 비밀번호

• Freedcamp의 프로젝트 ID

설치(수동 호출에만 해당, IDE 또는 기타 MCP 데스크톱 클라이언트와 함께 사용하는 경우에는 필요하지 않음)

1. 저장소를 복제합니다.

지엑스피1

2. 종속성 설치:

npm install

3. Freedcamp 자격 증명을 사용하여 루트 디렉토리에 .env 파일을 만듭니다.

FREEDCAMP_API_KEY=your_api_key
FREEDCAMP_API_SECRET=your_api_secret
FREEDCAMP_PROJECT_ID=your_project_id

용법

서버 실행

먼저 TypeScript 코드를 빌드합니다.

npm run build

그런 다음 서버를 시작합니다.

npm start

테스트 하네스 실행

이 프로젝트에는 모든 MCP 기능을 검증하는 포괄적인 테스트 하네스가 포함되어 있습니다.

npm test

테스트 하네스는 다음과 같은 검사를 수행합니다.

1. 적절한 프로토콜 버전을 사용한 서버 초기화

2. 도구 목록 및 기능 검증

3. 다양한 매개변수를 사용한 작업 생성

4. 상태 변경을 포함한 작업 업데이트

5. 작업 목록 및 검증

사용 가능한 도구

1. freedcamp_add_task

   • Freedcamp에서 새 작업을 만듭니다.

   • 매개변수:

     • title (필수): 작업 제목

     • description (선택 사항): 작업 설명

     • priority (선택사항): 작업 우선순위(0-3)

     • due_date (선택 사항): 작업 마감일(YYYY-MM-DD)

     • assigned_to_id (선택 사항): 작업을 할당할 사용자 ID

2. freedcamp_update_task

   • 기존 작업을 업데이트합니다

   • 매개변수:

     • task_id (필수): 업데이트할 작업의 ID

     • title (선택 사항): 새 작업 제목

     • description (선택 사항): 새 작업 설명

     • priority (선택사항): 새 작업 우선순위(0-3)

     • due_date (선택 사항): 새로운 마감일(YYYY-MM-DD)

     • assigned_to_id (선택 사항): 작업을 할당할 새 사용자 ID

     • status (선택 사항): 새 작업 상태(0=열림, 1=완료, 2=닫힘)

3. freedcamp_list_tasks

   • 구성된 Freedcamp 프로젝트의 모든 작업을 나열합니다.

   • 매개변수가 필요하지 않습니다(환경 변수의 프로젝트 ID 사용)

   • 작업의 세부 정보가 포함된 작업 목록을 반환합니다.

IDE 통합

저장소를 복제하지 않고도 npx 사용하여 서버를 직접 실행할 수 있습니다.

커서

1. 프로젝트 루트에서 .cursor/mcp.json 엽니다(또는 만듭니다).

2. Freedcamp MCP 서버 구성을 추가하세요.

   {
     "mcpServers": {
       "freedcamp": {
         "command": "npx",
         "args": ["freedcamp-mcp"],
         "env": {
           "FREEDCAMP_API_KEY": "your_api_key",
           "FREEDCAMP_API_SECRET": "your_api_secret",
           "FREEDCAMP_PROJECT_ID": "your_project_id"
         }
       }
     }
   }

3. 커서를 다시 시작하거나 MCP 서버를 다시 로드하세요.

루

1. Roo MCP 구성 파일(일반적으로 roo.mcp.json 또는 이와 유사한 파일)을 열거나 만듭니다.

2. Freedcamp MCP 서버 구성을 추가하세요.

   {
     "mcpServers": {
       "Freedcamp": {
         "transport": "stdio",
         "command": "npx",
         "args": ["freedcamp-mcp"],
         "env": {
           "FREEDCAMP_API_KEY": "your_api_key",
           "FREEDCAMP_API_SECRET": "your_api_secret",
           "FREEDCAMP_PROJECT_ID": "your_project_id"
         }
       }
     }
   }