integration-mcp-server/README.md

Integration MCP Server with YouTrack, Forgejo, and language server capabilities - easy setup for Claude Desktop & VSCode with Windows compatibility

# Integration MCP Server

통합 MCP(Model Context Protocol) 서버로 YouTrack, Forgejo, 그리고 언어 서버 기능을 제공합니다.

## 🚀 빠른 시작

### 설치

```bash
npm install -g integration-mcp-server
```

### 사용법

#### 직접 실행
```bash
# 기본 실행
integration-mcp-server

# 또는 짧은 명령어
imcp

# 개발 모드로 실행
integration-mcp-server start --dev
```

#### npx로 실행 (설치 없이)
```bash
npx integration-mcp-server
```

## 📋 Claude Desktop 설정

`claude_desktop_config.json` 파일에 다음을 추가하세요:

### Windows
```json
{
  "mcpServers": {
    "integration-mcp-server": {
      "command": "cmd",
      "args": ["/c", "npx", "integration-mcp-server"],
      "env": {}
    }
  }
}
```

### macOS/Linux
```json
{
  "mcpServers": {
    "integration-mcp-server": {
      "command": "npx",
      "args": ["integration-mcp-server"],
      "env": {}
    }
  }
}
```

## 🔧 VSCode 설정

`.vscode/settings.json` 파일에 다음을 추가하세요:

### Windows
```json
{
  "mcp.servers": {
    "integration-mcp-server": {
      "command": "cmd",
      "args": ["/c", "npx", "integration-mcp-server"],
      "env": {}
    }
  }
}
```

### macOS/Linux
```json
{
  "mcp.servers": {
    "integration-mcp-server": {
      "command": "npx",
      "args": ["integration-mcp-server"],
      "env": {}
    }
  }
}
```

## 🛠️ 제공 도구

- **echo**: 텍스트를 그대로 반환
- **get_time**: 현재 시간 조회
- **analyze_project**: 프로젝트 구조 분석

## 🐛 문제 해결

### Windows에서 "spawn npx ENOENT" 오류
Windows에서는 `npx`가 배치 파일이므로 `cmd /c`로 감싸서 실행해야 합니다:

```json
{
  "command": "cmd",
  "args": ["/c", "npx", "integration-mcp-server"]
}
```

## 📚 상세 가이드

- [초보자용 설정 가이드](./MCP_SETUP_GUIDE_BEGINNER.md)
- [빠른 시작 가이드](./QUICK_START.md)

## 🔄 개발

```bash
# 저장소 클론
git clone <repository-url>
cd integration-mcp-server

# 의존성 설치
npm install

# 개발 모드 실행
npm run dev

# 빌드
npm run build
```

## 📄 라이선스

MIT