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

许可证

麻省理工学院