Redmine MCP Server for Cline

Cline용 Redmine MCP 서버

이는 Redmine과 통합된 맞춤형 MCP(Model Context Protocol) 서버로, Cline VS Code 확장 기능을 통해 Redmine 프로젝트와 이슈와 상호 작용할 수 있습니다.

필수 조건

• Node.js: 시스템에 Node.js(버전 18 이상)가 설치되어 있어야 합니다.
• Redmine 인스턴스: REST API가 활성화된 실행 중인 Redmine 인스턴스가 필요합니다.
• Redmine API 키: Redmine 사용자 계정의 API 키가 필요합니다. Redmine 계정 설정(일반적으로 "내 계정" -> "API 액세스 키" 아래)에서 찾을 수 있습니다.
• 클라인: 클라인 VS 코드 확장 프로그램을 설치하고 구성해야 합니다.

설치

1. 저장소를 복제합니다.지엑스피1
2. 종속성 설치:
   npm install

구성

1. 환경 변수 설정: 프로젝트 디렉토리의 루트에 .env 파일을 만들고 다음을 추가합니다. 이때 플레이스홀더를 실제 Redmine 호스트 이름과 API 키로 바꿉니다.
   REDMINE_HOST=your-redmine-host.com REDMINE_API_KEY=your-redmine-api-key
   중요: .env 파일을 버전 관리 시스템에 커밋하지 마세요! 민감한 정보가 포함되어 있습니다. 이 저장소에 포함된 .gitignore 파일이 커밋을 방지합니다.

클라인에 추가

1. Cline 설정 열기: VS Code에서 Cline 확장 프로그램을 열고 MCP 서버 탭으로 이동합니다.
2. MCP 설정 편집: "MCP 설정 편집"을 클릭하여 cline_mcp_settings.json 파일을 엽니다.
3. 서버를 추가합니다. mcpServers 개체에 다음 항목을 추가하고 args 경로를 시스템의 server.js 파일에 대한 절대 경로로 바꿉니다.
   { "mcpServers": { "redmine-server": { "command": "node", "args": ["C:\\Users\\yourusername\\path\\to\\Redmine-MCP\\server.js"], "disabled": false, "autoApprove": [] } } }
   중요: Windows에서는 경로에 반드시 두 개의 백슬래시( \\ )를 사용하세요.
4. 저장: cline_mcp_settings.json 파일을 저장합니다. Cline이 자동으로 변경 사항을 감지하고 서버를 시작합니다.

사용 가능한 리소스 및 도구

자원

• redmine://projects/{project_id} : 이 리소스는 Redmine 프로젝트를 나타냅니다. {project_id} Redmine 인스턴스에 있는 프로젝트의 실제 ID로 바꾸세요. Cline의 access_mcp_resource 도구를 사용하여 프로젝트 세부 정보를 읽을 수 있습니다. 예:
  <access_mcp_resource> <server_name>redmine-server</server_name> <uri>redmine://projects/123</uri> </access_mcp_resource>

( 123 유효한 프로젝트 ID로 바꾸세요.) 그러면 프로젝트 세부 정보가 JSON으로 반환됩니다.

도구

• create_issue : 이 도구를 사용하면 Redmine에서 새 이슈를 생성할 수 있습니다. 다음 매개변수를 사용합니다.
  • project_id (문자열, 필수): 문제가 생성되어야 하는 프로젝트의 ID입니다.
  • subject (문자열, 필수): 문제의 제목입니다.
  • description (문자열, 필수): 문제에 대한 설명입니다.

  Cline의 use_mcp_tool 도구를 사용하여 이 도구를 호출할 수 있습니다. 예:

  <use_mcp_tool> <server_name>redmine-server</server_name> <tool_name>create_issue</tool_name> <arguments> { "project_id": "456", "subject": "My New Issue", "description": "This is a test issue created via Cline." } </arguments> </use_mcp_tool>

  ( 456 유효한 프로젝트 ID로 바꾸세요.) 이렇게 하면 지정된 프로젝트에 새 이슈가 생성되고 이슈 세부 정보가 JSON으로 반환됩니다.

문제 해결

• 연결 종료 오류: "MCP 오류 -1: 연결 종료"와 같은 오류가 표시되면 REDMINE_HOST 및 REDMINE_API_KEY 환경 변수가 올바르게 설정되어 있는지 확인하세요. 또한, 컴퓨터에서 Redmine 인스턴스에 액세스할 수 있는지도 확인하세요.
• 서버 로그 확인: 문제가 발생하면 VS Code 터미널에서 서버 출력을 확인하여 오류 메시지를 확인하세요. 서버는 콘솔에 오류를 기록합니다.