User
 │
 │ "How many leaves do I have?"
 ▼
Claude Desktop
 │
 │ MCP Tool Call
 ▼
Leave Manager MCP Server
 │
 ▼
Dummy Database
 │
 ▼
Leave Balance
 │
 ▼
Claude Desktop
 │
 ▼
Natural Language Response

기능

현재 버전은 다음과 같은 MCP 도구를 제공합니다:

직원 휴가 잔여 일수 조회
직원 휴가 내역 조회
사용 가능한 휴가 유형 조회
휴가 신청
휴가 취소
Zod를 사용한 입력 검증
더미/인메모리 데이터베이스
TypeScript 구현
stdio 기반 MCP 전송
MCP Inspector 지원
Claude Desktop 통합

아키텍처

현재 아키텍처는 다음과 같습니다:

                    ┌──────────────────────┐
                    │    Claude Desktop    │
                    │                      │
                    │   User Interaction   │
                    └──────────┬───────────┘
                               │
                               │ MCP / stdio
                               ▼
                    ┌──────────────────────┐
                    │ Leave Manager MCP    │
                    │      Server          │
                    │                      │
                    │ MCP Tool Layer       │
                    └──────────┬───────────┘
                               │
                               ▼
                    ┌──────────────────────┐
                    │    Leave Service     │
                    │    / Repository      │
                    └──────────┬───────────┘
                               │
                               ▼
                    ┌──────────────────────┐
                    │     Dummy DB         │
                    │                      │
                    │ employees[]          │
                    │ leaveBalances[]      │
                    │ leaveRequests[]      │
                    └──────────────────────┘

서버는 stdio를 사용합니다. Claude Desktop이 MCP 서버를 로컬 프로세스로 실행하고 표준 입력/출력을 통해 통신할 수 있기 때문입니다. MCP TypeScript SDK는 이 사용 사례를 위해 serveStdio()를 제공합니다.

기술 스택

기술	용도
TypeScript	애플리케이션 개발
Node.js	런타임
npm	의존성 관리
MCP TypeScript SDK	MCP 서버 구현
Zod	입력 검증
Claude Desktop	MCP 클라이언트
MCP Inspector	로컬 MCP 테스트
더미 DB	임시 데이터 저장

현재 MCP TypeScript SDK v2는 안정적인 SDK 라인이며 @modelcontextprotocol/server를 사용합니다.

사전 요구 사항

시작하기 전에 다음이 설치되어 있는지 확인하세요.

Node.js

Node.js 20 이상이 필요합니다.

설치된 버전 확인:

node --version

예시:

v22.9.0

npm 확인:

npm --version

Claude Desktop

머신에 Claude Desktop을 설치하세요.

Claude Desktop은 MCP 클라이언트 역할을 하며 Leave Manager MCP 서버를 로컬에서 실행합니다.

설치

1. 리포지토리 클론

git clone <YOUR_REPOSITORY_URL>

프로젝트로 이동:

cd leave-manager-mcp

2. 의존성 설치

실행:

npm install

프로젝트는 MCP TypeScript 서버 패키지를 사용합니다:

npm install @modelcontextprotocol/server

Zod는 도구 입력 검증에 사용됩니다:

npm install zod

TypeScript 개발용:

npm install -D typescript tsx @types/node

공식 MCP 서버 설정은 현재 Node.js 20+, ES 모듈, @modelcontextprotocol/server, Zod, tsx를 사용합니다.

프로젝트 구조

권장 프로젝트 구조:

leave-manager-mcp/
│
├── src/
│   │
│   ├── index.ts
│   │
│   ├── data/
│   │   └── dummy-db.ts
│   │
│   ├── models/
│   │   └── leave.ts
│   │
│   ├── repositories/
│   │   └── leave-repository.ts
│   │
│   └── tools/
│       └── leave-tools.ts
│
├── dist/
│
├── package.json
├── package-lock.json
├── tsconfig.json
└── README.md

역할

`src/index.ts`

MCP 서버를 생성하고 시작합니다.

`src/models/leave.ts`

직원 및 휴가와 관련된 TypeScript 모델/인터페이스를 포함합니다.

`src/data/dummy-db.ts`

임시 인메모리 테스트 데이터를 포함합니다.

`src/repositories/leave-repository.ts`

데이터 액세스 작업을 제공합니다.

`src/tools/leave-tools.ts`

Claude가 호출할 수 있는 MCP 도구를 등록합니다.

구성

package.json

일반적인 구성:

{
  "name": "leave-manager-mcp",
  "version": "1.0.0",
  "description": "Leave Manager MCP Server",
  "type": "module",
  "scripts": {
    "dev": "tsx src/index.ts",
    "build": "tsc",
    "start": "node dist/index.js"
  },
  "dependencies": {
    "@modelcontextprotocol/server": "^2.0.0",
    "zod": "^4.0.0"
  },
  "devDependencies": {
    "@types/node": "^24.0.0",
    "tsx": "^4.0.0",
    "typescript": "^6.0.0"
  }
}

의존성 버전은 npm install 실행 시점에 따라 다를 수 있습니다. 항상 npm이 생성한 버전을 우선 사용하세요.

TypeScript 구성

tsconfig.json 생성:

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "types": ["node"],
    "outDir": "dist"
  },
  "include": [
    "src/**/*.ts"
  ]
}

Node types 항목은 현재 TypeScript 버전에서 중요합니다. MCP SDK의 게시된 타입 정의가 Node API를 참조하기 때문입니다.

사용 가능한 MCP 도구

현재 Leave Manager MCP 서버는 다음 도구를 노출합니다.

1. get_leave_balance

직원의 현재 휴가 잔여 일수를 반환합니다.

입력

{
  "employeeId": "EMP001"
}

결과 예시

{
  "employeeId": "EMP001",
  "casual": 8,
  "sick": 5,
  "earned": 12,
  "unpaid": 0
}

2. get_leave_history

직원의 휴가 내역을 반환합니다.

입력

{
  "employeeId": "EMP001"
}

결과 예시

[
  {
    "id": "LR001",
    "employeeId": "EMP001",
    "leaveType": "CASUAL",
    "startDate": "2026-08-20",
    "endDate": "2026-08-21",
    "reason": "Personal work",
    "status": "APPROVED"
  }
]

3. get_leave_types

사용 가능한 휴가 유형을 반환합니다.

결과 예시

[
  {
    "type": "CASUAL",
    "description": "Casual leave"
  },
  {
    "type": "SICK",
    "description": "Sick leave"
  },
  {
    "type": "EARNED",
    "description": "Earned leave"
  },
  {
    "type": "UNPAID",
    "description": "Unpaid leave"
  }
]

4. apply_leave

새 휴가 요청을 생성합니다.

입력

{
  "employeeId": "EMP001",
  "leaveType": "CASUAL",
  "startDate": "2026-09-10",
  "endDate": "2026-09-11",
  "reason": "Family function"
}

결과 예시

{
  "id": "LR002",
  "employeeId": "EMP001",
  "leaveType": "CASUAL",
  "startDate": "2026-09-10",
  "endDate": "2026-09-11",
  "reason": "Family function",
  "status": "PENDING"
}

5. cancel_leave

기존 휴가 요청을 취소합니다.

입력

{
  "leaveId": "LR002"
}

결과 예시

{
  "id": "LR002",
  "status": "CANCELLED"
}

MCP 서버 실행

개발 중 서버를 실행하는 방법은 두 가지가 있습니다.

옵션 1: tsx로 직접 실행

개발 중에는 이 방법을 권장합니다.

npm run dev

내부적으로 다음을 실행합니다:

tsx src/index.ts

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

Leave Manager MCP server running...

stdio MCP 서버는 클라이언트가 통신할 때까지 대기하므로 프로세스는 계속 실행됩니다.

다음을 사용하여 서버를 중지합니다:

Ctrl + C

프로젝트 빌드

컴파일된 버전을 사용하기 전에 다음을 실행합니다:

npm run build

다음을 실행합니다:

tsc

컴파일된 JavaScript 파일은 다음 위치에 생성됩니다:

dist/

예상 구조:

dist/
├── index.js
├── data/
│   └── dummy-db.js
├── models/
│   └── leave.js
├── repositories/
│   └── leave-repository.js
└── tools/
    └── leave-tools.js

프로덕션 빌드 실행

빌드 후:

npm start

다음을 실행합니다:

node dist/index.js

MCP 서버는 컴파일된 JavaScript로 시작됩니다.

MCP Inspector로 테스트

서버를 Claude Desktop에 연결하기 전에 MCP Inspector로 테스트하는 것이 좋습니다.

MCP Inspector는 MCP 서버에 연결하고 해당 도구를 직접 호출할 수 있는 로컬 UI를 제공합니다.

Inspector 시작

프로젝트 루트에서:

npx @modelcontextprotocol/inspector npm run dev

또는:

npx @modelcontextprotocol/inspector npx tsx src/index.ts

Inspector는 브라우저 URL을 제공합니다.

브라우저에서 해당 URL을 엽니다.

MCP Inspector에서 도구 테스트

서버 연결 후 다음을 엽니다:

Tools

섹션.

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

get_leave_balance
get_leave_history
get_leave_types
apply_leave
cancel_leave

`get_leave_balance` 테스트

선택:

get_leave_balance

입력:

{
  "employeeId": "EMP001"
}

예상 응답:

{
  "employeeId": "EMP001",
  "casual": 8,
  "sick": 5,
  "earned": 12,
  "unpaid": 0
}

`get_leave_history` 테스트

입력:

{
  "employeeId": "EMP001"
}

`get_leave_types` 테스트

이 도구는 입력이 필요하지 않습니다.

`apply_leave` 테스트

입력:

{
  "employeeId": "EMP001",
  "leaveType": "CASUAL",
  "startDate": "2026-09-10",
  "endDate": "2026-09-11",
  "reason": "Family function"
}

`cancel_leave` 테스트

입력:

{
  "leaveId": "LR002"
}

Claude Desktop 연결

서버가 MCP Inspector에서 올바르게 작동하면 Claude Desktop에 연결합니다.

Claude Desktop이 프로세스를 실행하고 stdin/stdout을 통해 통신하므로 MCP 서버는 로컬 stdio 서버로 구성되어야 합니다.

1. 프로젝트 빌드

먼저 실행:

npm run build

이 파일이 존재하는지 확인:

dist/index.js

2. 절대 프로젝트 경로 가져오기

프로젝트 루트에서:

pwd

예시:

/Users/ashish/projects/leave-manager-mcp

따라서 서버 경로는 다음과 같습니다:

/Users/ashish/projects/leave-manager-mcp/dist/index.js

Claude Desktop 구성에서 절대 경로를 사용하세요.

Claude Desktop 구성

Leave Manager MCP 서버를 Claude Desktop의 MCP 구성에 추가합니다.

예시:

{
  "mcpServers": {
    "leave-manager": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/leave-manager-mcp/dist/index.js"
      ]
    }
  }
}

예를 들어, macOS에서:

{
  "mcpServers": {
    "leave-manager": {
      "command": "node",
      "args": [
        "/Users/ashish/projects/leave-manager-mcp/dist/index.js"
      ]
    }
  }
}

경로를 실제 머신의 절대 경로로 바꾸세요.

중요: Claude Desktop 다시 시작

MCP 구성을 변경한 후:

구성을 저장합니다.
Claude Desktop을 완전히 종료합니다.
Claude Desktop을 다시 시작합니다.
새 대화를 엽니다.
사용 가능한 MCP 도구를 확인합니다.

Leave Manager 서버와 해당 도구가 표시되어야 합니다.

Claude로 Leave Manager 테스트

연결되면 MCP 도구를 수동으로 호출할 필요가 없습니다.

Claude에게 자연어로 질문하기만 하면 됩니다.

예시 1 — 휴가 잔여 일수

질문:

How many leaves does EMP001 have?

Claude는 다음을 사용해야 합니다:

get_leave_balance

다음과 함께:

{
  "employeeId": "EMP001"
}

예시 2 — 휴가 내역

질문:

Show me the leave history of EMP001.

Claude는 다음을 사용해야 합니다:

get_leave_history

예시 3 — 사용 가능한 휴가 유형

질문:

What types of leaves are available?

Claude는 다음을 사용해야 합니다:

get_leave_types

예시 4 — 휴가 신청

질문:

Apply casual leave for EMP001 from September 10 to September 11 because of a family function.

Claude는 다음을 사용해야 합니다:

apply_leave

적절한 매개변수와 함께.

예시 5 — 휴가 취소

질문:

Cancel leave request LR002.

Claude는 다음을 사용해야 합니다:

cancel_leave

더미 데이터베이스

현재 구현은 인메모리 데이터베이스를 사용합니다.

예시:

export const employees = [
  {
    id: "EMP001",
    name: "Ashish Kushwaha",
    email: "ashish@example.com",
    department: "Engineering"
  }
];

휴가 잔여 일수:

export const leaveBalances = [
  {
    employeeId: "EMP001",
    casual: 8,
    sick: 5,
    earned: 12,
    unpaid: 0
  }
];

휴가 요청:

export const leaveRequests = [
  {
    id: "LR001",
    employeeId: "EMP001",
    leaveType: "CASUAL",
    startDate: "2026-08-20",
    endDate: "2026-08-21",
    reason: "Personal work",
    status: "APPROVED",
    createdAt: "2026-08-10"
  }
];

더미 DB 중요 제한 사항

현재 데이터베이스는 애플리케이션 메모리에 저장됩니다.

따라서:

Server starts
      ↓
Dummy data loaded
      ↓
Apply leave
      ↓
New request added
      ↓
Server stops
      ↓
Data is lost

이는 예상된 동작입니다.

더미 데이터베이스는 개발 및 MCP 테스트용으로만 사용됩니다.

개발 워크플로

권장 개발 워크플로:

1. Modify TypeScript
        ↓
2. Run npm run build
        ↓
3. Run MCP Inspector
        ↓
4. Test MCP tools
        ↓
5. Fix issues
        ↓
6. Test with Claude Desktop
        ↓
7. Commit changes

개발 중에는 다음을 사용할 수도 있습니다:

npm run dev

매번 변경 후 빌드하는 대신.

로깅

서버가 stdio를 사용하므로 일반 서버 로깅에 console.log()를 사용하지 마세요.

피해야 할 것:

console.log("Server started");

사용할 것:

console.error("Server started");

이유는 stdout이 MCP 프로토콜 통신에 사용되기 때문입니다. stdout에 일반 로그를 작성하면 JSON-RPC/MCP 통신 스트림이 손상될 수 있습니다.

문제 해결

문제: `Cannot find module`

실행:

rm -rf node_modules
rm -f package-lock.json
npm install

그런 다음:

npm run build

문제: TypeScript 빌드 오류

실행:

npx tsc --noEmit

파일을 생성하지 않고 TypeScript 오류를 표시합니다.

문제: `dist/index.js`가 존재하지 않음

실행:

npm run build

그런 다음 확인:

ls dist

문제: Claude Desktop에 MCP 서버가 표시되지 않음

확인:

MCP 구성이 유효한 JSON인지.
dist/index.js 경로가 절대 경로인지.
npm run build가 성공적으로 완료되었는지.
dist/index.js가 존재하는지.
Node.js가 설치되어 있는지.
Claude Desktop이 완전히 다시 시작되었는지.
MCP 서버가 MCP Inspector에서 작동하는지.

문제: MCP Inspector가 연결할 수 없음

먼저 실행:

npm run dev

서버가 성공적으로 시작되면 중지하고 다음을 실행:

npx @modelcontextprotocol/inspector npm run dev

터미널에서 오류를 확인하세요.

문제: 서버가 시작되지만 도구가 표시되지 않음

확인:

src/index.ts

도구가 등록되어 있는지 확인:

registerLeaveTools(
  server,
  repository
);

또한 serveStdio()가 호출되는지 확인:

void serveStdio(createServer);

문제: JSON-RPC/MCP 프로토콜 오류

코드에서 다음을 확인:

console.log(...)

일반 로깅을 다음으로 교체:

console.error(...)

stdout은 MCP 프로토콜 통신을 위해 사용 가능한 상태로 유지되어야 합니다.

향후 개선 사항

현재 버전은 프로토타입입니다. 다음 개선 사항이 권장됩니다.

데이터베이스

더미 데이터베이스를 다음으로 교체:

PostgreSQL
MySQL
MongoDB

또는 기존 내부 휴가 관리 API.

인증

사용자가 다음을 직접 제공하지 않도록 직원 인증 추가:

employeeId

수동으로.

향후 아키텍처:

Claude
   ↓
MCP Server
   ↓
Authentication
   ↓
Employee Context
   ↓
Leave Service

휴가 검증

비즈니스 규칙 추가:

휴가 날짜 검증
휴가 잔여 일수 검증
중복 휴가 방지
회사 공휴일 확인
주말 확인
최소/최대 휴가 기간 검증
직원 상태 검증
휴가 유형 검증
해당되는 경우 승인 후 취소 방지

관리자 승인

다음과 같은 도구 추가:

get_pending_leave_requests
approve_leave
reject_leave

팀 캘린더

추가:

get_team_leave_calendar

사용자 요청 예시:

Who from my team is on leave next week?

알림

다음과 통합:

Email
Slack
Microsoft Teams

직원과 관리자에게 알림.

권장 프로덕션 아키텍처

장기 아키텍처는 MCP를 비즈니스 로직에서 분리해야 합니다:

                    Claude Desktop
                          │
                          │ MCP
                          ▼
                ┌───────────────────┐
                │    MCP Server     │
                │                   │
                │ Tool Definitions  │
                │ Input Validation  │
                └─────────┬─────────┘
                          │
                          ▼
                ┌───────────────────┐
                │   Leave Service   │
                │                   │
                │ Business Rules    │
                │ Validation        │
                │ Authorization     │
                └─────────┬─────────┘
                          │
                          ▼
                ┌───────────────────┐
                │ Leave Repository  │
                └─────────┬─────────┘
                          │
                 ┌────────┴────────┐
                 ▼                 ▼
          Internal Leave API    Database

이렇게 하면 Claude에 노출된 도구를 변경하지 않고 더미 데이터베이스를 교체할 수 있습니다.

보안 고려 사항

현재 프로젝트는 개발/테스트 전용입니다.

실제 직원 데이터와 함께 사용하기 전에:

인증을 추가하세요.
권한 부여를 추가하세요.
모델이 제공한 employeeId를 신뢰하지 마세요.
모든 도구 입력의 유효성을 검사하세요.
직원 정보를 보호하세요.
불필요한 직원 데이터를 노출하지 마세요.
감사 로깅을 추가하세요.
역할 기반 액세스 제어를 구현하세요.
관리자 전용 작업을 보호하세요.
해당되는 경우 속도 제한을 추가하세요.
소스 코드에 비밀을 저장하지 마세요.
자격 증명에는 환경 변수를 사용하세요.
내부 API/데이터베이스에 대한 연결을 보호하세요.

MCP 서버는 Claude가 보안 결정을 내리도록 하는 대신 비즈니스 권한을 강제해야 합니다.

환경 변수

실제 서비스에 연결할 때는 환경 변수를 사용하세요.

예시 .env:

LEAVE_API_URL=https://internal.example.com/api
LEAVE_API_KEY=your-api-key

.env를 Git에 커밋하지 마세요.

추가:

.env

.gitignore에.

Git 무시

권장 .gitignore:

node_modules/
dist/
.env
.DS_Store
*.log

유용한 명령어

종속성 설치

npm install

개발

npm run dev

빌드

npm run build

컴파일된 서버 실행

npm start

타입 검사

npx tsc --noEmit

MCP Inspector 실행

npx @modelcontextprotocol/inspector npm run dev

Node 버전 확인

node --version

npm 버전 확인

npm --version

MCP 개발 체크리스트

MCP 서버가 내부 테스트 준비가 되었다고 간주하기 전에:

Node.js 20+ 설치됨
종속성 설치됨
TypeScript 빌드 성공
더미 데이터베이스 구성됨
MCP 서버가 성공적으로 시작됨
MCP Inspector가 성공적으로 연결됨
get_leave_balance 테스트됨
get_leave_history 테스트됨
get_leave_types 테스트됨
apply_leave 테스트됨
cancel_leave 테스트됨
Claude Desktop 구성 추가됨
Claude Desktop 다시 시작됨
Claude에서 Leave Manager 도구 표시됨
자연어 요청 테스트됨
오류 시나리오 테스트됨

예시 사용자 쿼리

Claude Desktop에 연결되면 사용자는 다음과 같은 질문을 할 수 있어야 합니다:

How many casual leaves do I have?

Show my leave history.

What leave types are available?

Apply casual leave from September 10 to September 11.

Cancel my leave request LR002.

향후 예시:

Do I have enough leave for next Monday?

Who from my team is on leave next week?

Show all pending leave requests.

Approve Rahul's leave request.

MCP 리소스

공식 MCP TypeScript SDK:

https://ts.sdk.modelcontextprotocol.io/v2/

공식 첫 서버 가이드:

https://ts.sdk.modelcontextprotocol.io/v2/get-started/first-server

공식 서버 API:

https://ts.sdk.modelcontextprotocol.io/v2/api/@modelcontextprotocol/server/

이 프로젝트는 현재 MCP TypeScript SDK v2 아키텍처와 최신 2026-07-28 프로토콜 라인을 따릅니다.

라이선스

이 프로젝트는 내부 개발 및 테스트를 위한 것입니다.

여기에 조직의 라이선스 및 사용 정책을 추가하세요.

관리자

Ashish Kushwaha

Leave Manager MCP Server TypeScript + MCP + Claude Desktop

빠른 시작

숙련된 개발자의 경우 전체 설정은 다음과 같이 요약할 수 있습니다:

# Clone
git clone <YOUR_REPOSITORY_URL>

# Enter project
cd leave-manager-mcp

# Install
npm install

# Build
npm run build

# Run
npm start

# Development
npm run dev

# MCP Inspector
npx @modelcontextprotocol/inspector npm run dev

그런 다음 Claude Desktop이 시작하도록 구성합니다:

dist/index.js

사용:

{
  "mcpServers": {
    "leave-manager": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/leave-manager-mcp/dist/index.js"
      ]
    }
  }
}

Claude Desktop을 다시 시작하고 Leave Manager MCP 도구 테스트를 시작하세요.

This server cannot be installed

license - not tested

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

mcp
GibsonAI MCP server: manage your databases with natural language
timeops
Hosted MCP server for business-day math, deadline planning, meeting overlap, and SLA calculations.
Microsoft MCP Server for Enterprise
Official Microsoft MCP Server to query Microsoft Entra data using natural language

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/developer-ashish31/leaveManagerMCP-JS'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

Leave Manager MCP Server

목차

개요

예시

기능

아키텍처

기술 스택

사전 요구 사항

Node.js

Claude Desktop

설치

1. 리포지토리 클론

2. 의존성 설치

프로젝트 구조

역할

src/index.ts

src/models/leave.ts

src/data/dummy-db.ts

src/repositories/leave-repository.ts

src/tools/leave-tools.ts

구성

package.json

TypeScript 구성

사용 가능한 MCP 도구

1. get_leave_balance

입력

결과 예시

2. get_leave_history

입력

결과 예시

3. get_leave_types

결과 예시

4. apply_leave

입력

결과 예시

5. cancel_leave

입력

결과 예시

MCP 서버 실행

옵션 1: tsx로 직접 실행

프로젝트 빌드

프로덕션 빌드 실행

MCP Inspector로 테스트

Inspector 시작

MCP Inspector에서 도구 테스트

get_leave_balance 테스트

get_leave_history 테스트

get_leave_types 테스트

apply_leave 테스트

cancel_leave 테스트

Claude Desktop 연결

1. 프로젝트 빌드

2. 절대 프로젝트 경로 가져오기

Claude Desktop 구성

중요: Claude Desktop 다시 시작

Claude로 Leave Manager 테스트

예시 1 — 휴가 잔여 일수

예시 2 — 휴가 내역

예시 3 — 사용 가능한 휴가 유형

예시 4 — 휴가 신청

예시 5 — 휴가 취소

더미 데이터베이스

더미 DB 중요 제한 사항

개발 워크플로

로깅

문제 해결

문제: Cannot find module

문제: TypeScript 빌드 오류

문제: dist/index.js가 존재하지 않음

문제: Claude Desktop에 MCP 서버가 표시되지 않음

문제: MCP Inspector가 연결할 수 없음

문제: 서버가 시작되지만 도구가 표시되지 않음

문제: JSON-RPC/MCP 프로토콜 오류

향후 개선 사항

데이터베이스

인증

휴가 검증

관리자 승인

팀 캘린더

알림

`src/index.ts`

`src/models/leave.ts`

`src/data/dummy-db.ts`

`src/repositories/leave-repository.ts`

`src/tools/leave-tools.ts`

`get_leave_balance` 테스트

`get_leave_history` 테스트

`get_leave_types` 테스트

`apply_leave` 테스트

`cancel_leave` 테스트

문제: `Cannot find module`

문제: `dist/index.js`가 존재하지 않음