AI导哈

员工管理MCP服务器

一个基于Python的MCP服务器，用于通过Claude Desktop管理员工数据，包括员工目录、搜索和详细档案。

  • by suchitad1950
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 suchitad1950/New-Version-of-MCP-Server

使用说明

员工管理MCP服务器🏢

一个初学者友好的模型上下文协议（MCP）服务器，用于使用Claude Desktop管理员工数据。

🚀 快速开始

此MCP服务器为Claude Desktop提供了对员工管理功能的访问，包括员工目录、搜索和详细配置文件。

所得

  • 10名员工 横跨6个部门（工程、市场营销、人力资源、财务、销售、运营）
  • 3个强大的工具 供克劳德使用
  • 实时员工数据 通过克劳德桌面访问
  • 初学者友好 设置和文档

📁 项目结构

📦 Employee-MCP-Server/
├── 🗂️ clean_project/
│   ├── 🚀 employee_server.py    # Main MCP server
│   ├── 📋 requirements.txt      # Python dependencies
│   └── 📖 README.md            # Project guide
├── 📄 pyproject.toml           # Project configuration
└── 📖 README.md               # This file

⚡ 特性

  • 员工目录：所有员工的完整名单及详细信息
  • 员工查询：获取特定员工的详细信息
  • 部门搜索：查找特定部门的所有员工
  • 实时数据：通过Claude Desktop即时访问
  • 整洁架构：组织良好，适合初学者的代码

🛠️ 安装和设置

先决条件

  • Python 3.13+
  • Claude桌面应用程序
  • Git（用于克隆）

1.克隆存储库

git clone https://github.com/suchitad1950/New-Version-of-MCP-Server.git
cd New-Version-of-MCP-Server

2.设置Python环境

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r clean_project/requirements.txt

3.配置克劳德桌面

将此添加到您的Claude Desktop配置文件中：

{
  "mcpServers": {
    "employee-leave-server": {
      "command": "/path/to/your/venv/bin/python",
      "args": ["/path/to/your/clean_project/employee_server.py"],
      "env": {
        "PYTHONPATH": "/path/to/your/clean_project",
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

4.开始使用

  1. 重新启动克劳德桌面
  2. 询问：“列出所有员工”或“显示员工目录”

💬 可用命令

问克劳德这些命令中的任何一个：

命令 描述
"List all employees" 完整的员工目录，包括所有详细信息
"Get details for employee EMP001" 特定员工简介
"Show employees in Engineering" 按部门筛选
"Find all Marketing employees" 部门特定搜索

👥 员工数据

您的服务器包含真实的员工数据：

部门和员工

  • 工程 （2） ：Sachin Goswami（高级工程师），Neha Patil（初级开发人员）
  • 营销 （2） ：Ravi Punekar（经理），Priya Mehta（营销与销售副总裁）
  • 人力资源 （1） ：Rahul Deshpande（人力资源总监）
  • 金融 （2） ：Archana Jadhav（分析师）、Vikram Singh（首席财务官）
  • 销售 （2） Preeti Kulkarni（执行）、Amit Sharma（经理）
  • 运营 （1） ：卡兰·乔希（协调员）

🔧 技术细节

  • 协议：模型上下文协议（MCP）
  • 语言：Python 3.13
  • 框架：MCP服务器SDK
  • 可用工具：3（列出所有员工，获取员工id，按部门搜索员工）
  • 数据格式：格式丰富的JSON响应

🐛 故障排除

克劳德看不见员工？

  1. 完全退出克劳德桌面（Mac上的⌘+Q）
  2. 等待10秒
  3. 重新打开克劳德桌面
  4. 尝试再次询问员工数据

服务器未启动？

  1. 检查Python环境是否已激活
  2. 验证是否安装了所有依赖项： pip install -r clean_project/requirements.txt
  3. 确保Claude配置中的文件路径正确

连接问题？

  1. 验证Claude Desktop配置文件位置
  2. 检查Python路径是否指向您的虚拟环境
  3. 确保服务器文件路径是绝对路径

🚀 接下来是什么？

该项目为更先进的MCP服务器奠定了基础：

潜在扩展

  • 休假管理：添加休假申请和审批工作流
  • 绩效评估：员工评估和反馈系统
  • 报告：生成部门和公司范围的报告
  • 整合：与人力资源系统、数据库或API连接
  • 认证：添加用户角色和权限

学习机会

  • 了解MCP协议实现
  • 学习异步Python编程
  • 探索克劳德桌面集成
  • 实践干净的代码架构

📄 许可证

这个项目是开源的，可以在MIT许可证下使用。

🤝 贡献

请随时提交问题和增强请求！

  1. 分叉存储库
  2. 创建功能分支
  3. 进行更改
  4. 提交拉取请求

📞 支持

如果您遇到任何问题：

  • 检查上面的故障排除部分
  • 查看clean_project/README.md以获取详细说明
  • 在GitHub上提交问题

内置于❤️ 对于MCP社区

该服务器演示了如何创建适合初学者的MCP服务器，这些服务器与Claude Desktop无缝集成，实现强大的人工智能与人类协作。

相关 MCP