AI导哈

AI助手数据协议服务器集合

一组用于AI助手的模型上下文协议(MCP)服务器，提供对多种业务数据源的访问，包含演示和开发用的人工数据。

  • by mferris
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 mferris/mcp-servers-collection

使用说明

MCP服务器集合

一组用于AI助手的模型上下文协议（MCP）服务器，提供对各种业务数据源的访问，其中包含用于演示和开发的人工数据。

包括服务器

1.客户数据MCP服务器

地点： ./customer-mcp-server/

为AI助手提供访问客户关系管理数据的权限。

特征：

  • 客户搜索和过滤
  • 客户详细信息，包括订单和支持票
  • 客户健康分析（流失风险）
  • 收入分析和趋势

工具： search_customers, get_customer_details, analyze_customer_health, revenue_analytics

2.人力资源管理数据MCP服务器

地点： ./hrm-mcp-server/

为人工智能助理提供人力资源管理数据的访问权限。

特征：

  • 员工搜索和管理
  • 部门信息和预算
  • 跨部门/职位的薪酬分析
  • 休假请求和余额
  • 绩效评估仪表板

工具： search_employees, get_employee_details, get_department_info, salary_analysis, time_off_summary, performance_dashboard

3.工程MCP服务器

地点： ./engineering-mcp-server/

为人工智能助理提供访问大规模工程组织数据的权限（8000多名工程师）。

特征：

  • 按团队、角色、级别和技能搜索工程师
  • 项目状态和健康跟踪
  • 存储库指标（安全性、质量、性能）
  • 部署分析和历史记录
  • 事件分析和响应跟踪
  • 代码审查指标和队列管理
  • 随叫随到的日程管理
  • 团队健康和生产力指标

工具： search_engineers, get_project_status, repository_metrics, deployment_dashboard, incident_analysis, code_review_metrics, oncall_schedule, team_health_metrics

快速开始

先决条件

  • Node.js 18+
  • npm或纱线
  • 克劳德桌面（用于测试）

安装

  1. 克隆存储库：

    git clone <your-repo-url>
cd mcp-servers-collection

  2. 为所有服务器安装依赖关系：

    # Customer MCP Server
cd customer-mcp-server
npm install
cd ..

# HRM MCP Server
cd hrm-mcp-server
npm install
cd ..

# Engineering MCP Server
cd engineering-mcp-server
npm install
cd ..

  3. 测试服务器：

    # Test Customer server
cd customer-mcp-server
npm run start
# Should see: "Customer Data MCP Server running on stdio"

# Test HRM server
cd ../hrm-mcp-server
npm run start
# Should see: "Unified HRM & Engineering MCP Server running on stdio"

# Test Engineering server
cd ../engineering-mcp-server
npm run start
# Should see: "Engineering MCP Server running on stdio"

Claude桌面配置

将所有三台服务器添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "customer-data": {
      "command": "node",
      "args": [
        "/path/to/mcp-servers-collection/customer-mcp-server/node_modules/.bin/tsx",
        "/path/to/mcp-servers-collection/customer-mcp-server/src/server.ts"
      ]
    },
    "hrm-data": {
      "command": "node",
      "args": [
        "/path/to/mcp-servers-collection/hrm-mcp-server/node_modules/.bin/tsx",
        "/path/to/mcp-servers-collection/hrm-mcp-server/src/server.ts"
      ]
    },
    "engineering-data": {
      "command": "node",
      "args": [
        "/path/to/mcp-servers-collection/engineering-mcp-server/node_modules/.bin/tsx",
        "/path/to/mcp-servers-collection/engineering-mcp-server/src/server.ts"
      ]
    }
  }
}

替换 /path/to/mcp-servers-collection 你的实际路径。

Docker支持

这两台服务器都支持Docker进行容器化部署：

# Customer server
cd customer-mcp-server
docker build -t customer-mcp-server .
docker run -it customer-mcp-server

# HRM server
cd hrm-mcp-server
docker build -t hrm-mcp-server .
docker run -it hrm-mcp-server

或者使用docker compose：

cd hrm-mcp-server
docker-compose up -d

使用示例

客户数据查询

  • “显示所有企业客户”
  • “哪些客户有流失的风险？”
  • “按客户级别划分，我们的总收入是多少？”
  • “显示Acme Corporation的客户详细信息”

人力资源管理数据查询

  • “显示工程部的所有员工”
  • “我们各部门的平均工资是多少？”
  • “谁有待处理的休假请求？”
  • “给我绩效评估仪表板”
  • “显示John Smith的员工详细信息”

样品数据

客户服务器

  • 3个样本客户（Acme Corporation、TechStart Inc、Global Solutions Ltd）
  • 客户层次：企业级、成长型、入门级
  • 订单历史和支持票
  • 收入分析和健康指标

人力资源管理服务器

  • 5个部门6名员工
  • 完整的人力资源档案（工资、联系方式、紧急联系人）
  • 部门预算和组织结构
  • 休假请求和绩效评估
  • 扣除的工资记录

发展

项目结构

mcp-servers-collection/
├── customer-mcp-server/
│   ├── src/server.ts          # Customer MCP server implementation
│   ├── package.json
│   ├── tsconfig.json
│   ├── Dockerfile
│   └── README.md
├── hrm-mcp-server/
│   ├── src/server.ts          # HRM MCP server implementation
│   ├── package.json
│   ├── tsconfig.json
│   ├── Dockerfile
│   ├── docker-compose.yml
│   └── README.md
└── README.md                  # This file

添加新服务器

  1. 为您的服务器创建一个新目录
  2. 遵循现有服务器中的MCP SDK模式
  3. 包含正确的TypeScript配置
  4. 添加Docker对容器化的支持
  5. 用使用示例更新此README

安全说明

  • 仅人工数据：所有服务器都使用完全人工数据
  • 无真实信息：不包括实际客户或员工数据
  • 沙盒：Docker容器在运行时受到安全限制
  • 教育目的：专为演示和开发而设计

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 将MCP服务器添加到新目录中
  4. 包括适当的文件和示例
  5. 提交拉取请求

许可证

麻省理工学院许可证-这些是用于教育和发展目的的人工数据演示工具。

支持

对于问题或疑问：

  1. 检查各个服务器的README文件
  2. 查看MCP SDK文档
  3. 在集成之前独立测试服务器
  4. 验证克劳德桌面配置

相关 MCP