π¦
Build MCP Server Template
No description available
0 installs
Trust: 35 β Low
Devtools
Ask AI about Build MCP Server Template
Powered by Claude Β· Grounded in docs
I know everything about Build MCP Server Template. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
Internal Data MCP Server
An MCP (Model Context Protocol) server that exposes internal organizational data β employee directory, project management, ticketing, and knowledge base β to AI assistants.
Companion blog post: How to Build MCP Servers for Your Internal Data (freeCodeCamp)
Features
- Employee directory search β find people by name, email, or role
- Project management β list projects by status, view team members
- Ticket lookup β query your internal ticketing system
- Knowledge base RAG β vector search across internal documents
- Authentication β Bearer token middleware with pluggable validation
- Resource endpoints β org structure overview, department details
Quick Start
Prerequisites
- Node.js 22+
- PostgreSQL 15+ with pgvector extension
- An OpenAI API key (for document embeddings)
Setup
# 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
The server runs at http://localhost:3100/mcp.
Connect with Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"internal-data": {
"url": "http://localhost:3100/mcp",
"headers": {
"Authorization": "Bearer your-token"
}
}
}
}
Stdio Mode (local)
npm run dev:stdio
Project Structure
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
docker build -t internal-data-mcp .
docker run -p 3100:3100 --env-file .env internal-data-mcp
License
MIT
