MCP Server Guide & Examples
About
A comprehensive guide and example implementations for building Model Context Protocol (MCP) servers in Python and TypeScript.
Details
- Author
- kaianuar
- Downloads
- 424
- Categories
- Other
Jump to
- Complete server examples in Python and TypeScript
- Demonstrates tools (calculate, fetch-json, file I/O)
- Static and dynamic resource examples
- Prompt templates and logging patterns
- Sandboxed file operations and error handling
- Type safety with TypeScript and Pydantic
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP Server Guide & ExamplesCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Choose a preferred implementation (Python or TypeScript), install dependencies (pip or npm), run the server script, then connect using the MCP CLI tool (mcp-cli connect). Refer to the server guide and language-specific documentation for details.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp server guide & examples": {
"mcp-server-guide": {
"command": "python",
"args": [
"server.py"
]
}
}
}
}McpServers
{
"mcp-server-guide": {
"command": "python",
"args": [
"server.py"
]
}
}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.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
