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 코드 확장 프로그램을 설치하고 구성해야 합니다.
Related MCP server: Code Knowledge MCP Server
설치
저장소를 복제합니다.
지엑스피1
종속성 설치:
npm install
구성
환경 변수 설정: 프로젝트 디렉토리의 루트에
.env파일을 만들고 다음을 추가합니다. 이때 플레이스홀더를 실제 Redmine 호스트 이름과 API 키로 바꿉니다.REDMINE_HOST=your-redmine-host.com REDMINE_API_KEY=your-redmine-api-key중요:
.env파일을 버전 관리 시스템에 커밋하지 마세요! 민감한 정보가 포함되어 있습니다. 이 저장소에 포함된.gitignore파일이 커밋을 방지합니다.
클라인에 추가
Cline 설정 열기: VS Code에서 Cline 확장 프로그램을 열고 MCP 서버 탭으로 이동합니다.
MCP 설정 편집: "MCP 설정 편집"을 클릭하여
cline_mcp_settings.json파일을 엽니다.서버를 추가합니다.
mcpServers개체에 다음 항목을 추가하고args경로를 시스템의server.js파일에 대한 절대 경로로 바꿉니다.{ "mcpServers": { "redmine-server": { "command": "node", "args": ["C:\\Users\\yourusername\\path\\to\\Redmine-MCP\\server.js"], "disabled": false, "autoApprove": [] } } }중요: Windows에서는 경로에 반드시 두 개의 백슬래시(
\\)를 사용하세요.저장:
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 터미널에서 서버 출력을 확인하여 오류 메시지를 확인하세요. 서버는 콘솔에 오류를 기록합니다.