MCP TypeScript Simple

A simple, production-ready MCP server that demonstrates how to build Model Context Protocol servers in TypeScript. Use it as an example, reference implementation, or framework for your own MCP projects.

View Source on GitHub | API Documentation

What is this?

This project shows you how to build production-quality MCP servers with:

• Dual Transport Support: STDIO (for desktop clients) + Streamable HTTP (for web/cloud)
• Multi-LLM Integration: Claude, OpenAI, and Gemini with type-safe APIs
• OAuth Authentication: Support for Google, GitHub, and Microsoft, or extend with your own
• Production Ready: Deploy to Vercel or Docker/K8s with full OTEL observability
• Comprehensive Testing: Full test coverage with CI/CD validation

Try It Out Now

Connect from Claude Code

claude mcp add https://mcp-typescript-simple.vercel.app/mcp

Connect from Claude Desktop

Add this to your Claude Desktop claude_desktop_config.json configuration file:

{
  "mcpServers": {
    "typescript-simple": {
      "command": "npx",
      "args": ["-y", "@mcp-typescript-simple/example-mcp"]
    }
  }
}

Connect from MCP Inspector

Test the hosted example server:

npx @modelcontextprotocol/inspector

Then in the UI, add: https://mcp-typescript-simple.vercel.app/mcp

Or test stdio mode:

npx @modelcontextprotocol/inspector npx -y @mcp-typescript-simple/example-mcp

Available Tools

This server provides several example tools to demonstrate MCP capabilities:

Basic Tools (Simple, non-LLM tools for testing)

• current-time - Get current timestamp
• hello - Greet users by name
• echo - Echo back messages

AI-Powered Tools (Require LLM API Keys Configured)

• chat - Interactive AI assistant with multi-provider support
• analyze - Deep text analysis
• summarize - Text summarization
• explain - Educational explanations

Documentation

• API Reference - Complete API documentation with interactive examples
• OpenAPI Specification - Machine-readable API spec
• GitHub Repository - Source code, developer guides, and examples
• Report Issues - Bug reports and feature requests

For Developers

Want to build your own MCP server, see the example code, or contribute? Check out the GitHub repository for:

• Complete TypeScript source code with comprehensive examples
• Step-by-step developer documentation
• Testing and validation guides
• Deployment instructions for Vercel, Docker, and more
• Modular package architecture you can reuse

License

MIT License - see LICENSE for details.