内部数据MCP服务器

一个MCP(模型上下文协议)服务器,将内部组织数据(员工目录、项目管理、票务和知识库)暴露给AI助手。

  • by mayur9210
  • TypeScript
  • 本地部署
  • 15 星标
  • 更新于
在 GitHub 查看 mayur9210/build-mcp-server-template

使用说明

内部数据MCP服务器

一个MCP(模型上下文协议)服务器,向人工智能助手公开内部组织数据——员工目录、项目管理、票务和知识库。

配套博客文章: 如何为您的内部数据构建MCP服务器 (freeCodeCamp)

特性

  • 员工目录搜索 --按姓名、电子邮件或角色查找人员
  • 项目管理 --按状态列出项目,查看团队成员
  • 门票查询 --查询您的内部票务系统
  • 知识库RAG --跨内部文档的矢量搜索
  • 认证 --带有可插拔验证的承载令牌中间件
  • 资源端点 --组织结构概述、部门详细信息

快速开始

先决条件

  • Node.js 22+
  • PostgreSQL 15+ pg向量 扩展
  • OpenAI API密钥(用于文档嵌入)

设置

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your database URL and API keys

# Create database tables
psql $INTERNAL_DB_URL < schema.sql

# Start the server
npm run dev

服务器运行在 http://localhost:3100/mcp.

与克劳德桌面连接

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "internal-data": {
      "url": "http://localhost:3100/mcp",
      "headers": {
        "Authorization": "Bearer your-token"
      }
    }
  }
}

标准模式(本地)

npm run dev:stdio

项目结构

src/
├── index.ts           # HTTP server with StreamableHTTP transport
├── stdio.ts           # Stdio transport (for local clients)
├── tools.ts           # MCP tool definitions
├── resources.ts       # MCP resource definitions
├── db.ts              # Database access layer
├── auth-middleware.ts  # Express auth middleware
└── client-example.ts  # Example client usage

码头工人

docker build -t internal-data-mcp .
docker run -p 3100:3100 --env-file .env internal-data-mcp

许可证

麻省理工学院