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 测试
虚拟数据库	临时数据存储

当前 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`

配置

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"
  ]
}

在当前的 TypeScript 版本中，Node types 条目很重要，因为 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 服务器

开发期间有两种方式运行服务器。

方式一：直接使用 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 提供一个本地 UI，用于连接 MCP 服务器并直接调用其工具。

启动 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。

MCP 服务器应配置为本地 stdio 服务器，因为 Claude Desktop 会启动该进程并通过 stdin/stdout 进行通信。

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"
  }
];

虚拟数据库的重要限制

当前数据库存储在应用程序内存中。

因此：

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

以通知员工和经理。

安全注意事项

当前项目仅用于开发/测试。

在将其用于真实员工数据之前：

添加身份验证。
添加授权。
不要信任模型提供的 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
Leave Manager 工具在 Claude 中可见
已测试自然语言请求
已测试错误场景

示例用户查询

连接到 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 服务器

方式一：直接使用 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 — 取消请假

虚拟数据库

虚拟数据库的重要限制

开发工作流

日志记录

故障排查

问题：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` 不存在