mcp-server-guide

MCP Server Guide & Examples

A comprehensive guide and collection of example implementations for building Model Context Protocol (MCP) servers. This repository demonstrates how to create MCP servers in multiple languages, with a focus on Python and TypeScript.

🚀 Features

• Complete Server Examples:

  • Python minimal server with async support
  • TypeScript minimal server with ES modules
  • Both implementations showcase core MCP concepts

• Core Functionality Examples:

  • Tools (calculate, fetch-json, file I/O)
  • Resources (static and dynamic)
  • Prompts and templates
  • Logging and error handling

• Security & Best Practices:

  • Sandboxed file operations
  • Error handling patterns
  • Logging strategies
  • Type safety (TypeScript/Pydantic)

📚 Documentation

• Server Guide - Main documentation and tutorial
• Python Example - Python implementation details
• TypeScript Example - TypeScript implementation details

🛠️ Quick Start

1. Choose your preferred implementation:

   # Python
   cd examples/python-minimal
   pip install -r requirements.txt
   python server.py
   
   # TypeScript
   cd examples/typescript-minimal
   npm install
   npm run build
   npm start
   

2. Connect using the MCP CLI:

   mcp-cli connect
   

📋 Prerequisites

• Python 3.8+ (for Python example)
• Node.js 16+ (for TypeScript example)
• MCP CLI tool (npm install -g @modelcontextprotocol/cli)

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the ISC License - see the LICENSE file for details.