MCP Server Template
A starter template for creating Model Context Protocol (MCP) servers that integrate with Claude Desktop and other MCP-compatible clients.
For details, check Anthroic mcp documentation https://docs.anthropic.com/en/docs/mcp
Features
- Stdio transport implementation, including Claude Desktop integration
- Configurable tool system with built-in and custom tools
- JSON-based configuration with environment variable overrides
- Docker support for containerized deployment
- Comprehensive logging and error handling
- TypeScript-ready structure
- Example tools for common operations
Quick Start
Installation
Configuration
Create a config.json
file in the project root:
Claude Desktop Integration
Add to your Claude Desktop configuration (claude_desktop_config.json
):
Project Structure
Creating Custom Tools
Create a new tool in the custom-tools
directory:
Built-in Tools
The template includes several built-in tools:
list_items
- List all items with optional filteringadd_item
- Add a new item to the systemremove_item
- Remove an item by IDsearch_items
- Search items with advanced queriesget_status
- Get system status and statistics
Environment Variables
Override configuration using environment variables:
MCP_SERVER_NAME
- Server nameMCP_VERSION
- Server versionMCP_DEBUG
- Enable debug loggingMCP_DATA_DIR
- Data directory pathMCP_OUTPUT_DIR
- Output directory pathMCP_CONFIG_PATH
- Custom config file path
Docker Deployment
Build and run with Docker:
Development
Running Tests
Linting
Building for Production
API Reference
Tool Schema
All tools follow this schema:
Configuration Schema
Extending the Template
Adding New Features
- Create feature modules in
src/features/
- Register with the server in
src/server/index.js
- Add configuration options to
config-loader.js
- Document in README and API reference
Creating Domain-Specific Servers
- Fork this template
- Replace example tools with domain-specific tools
- Customize configuration schema
- Update documentation
- Deploy as standalone MCP server
Troubleshooting
Common Issues
Server not starting:
- Check Node.js version (>=16.0.0)
- Verify configuration file syntax
- Check file permissions
Tools not loading:
- Verify tool file exports default object
- Check tool schema validity
- Review debug logs for errors
Claude Desktop integration:
- Ensure correct path in configuration
- Check server process is running
- Review Claude Desktop logs
Contributing
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch
- Add tests for new features
- Update documentation
- Submit a pull request
License
MIT License - see LICENSE file for details
Support
- GitHub Issues: Report bugs or request features
- Documentation: Full documentation
- Examples: See the
examples/
directory
Acknowledgments
Built for the Model Context Protocol ecosystem, enabling AI assistants to interact with external systems through a standardized interface.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A starter template for creating Model Context Protocol servers that integrate with Claude Desktop and other MCP-compatible clients. Provides a configurable tool system, Docker support, and TypeScript-ready structure for building custom MCP servers.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server built with mcp-framework that allows users to create and manage custom tools for processing data, integrating with the Claude Desktop via CLI.Last updated -235TypeScript
- -securityFlicense-qualityA starter template for building Model Context Protocol (MCP) servers, enabling developers to create and add custom tools that can be integrated with Claude Desktop.Last updated -2TypeScript
- AsecurityAlicenseAqualityA template repository for creating custom Model Context Protocol (MCP) servers in Python that can be integrated with applications like Claude Desktop or Cursor.Last updated -35PythonMIT License
- AsecurityFlicenseAqualityA Model Context Protocol server that allows integration with Claude Desktop by creating and managing custom tools that can be executed through the MCP framework.Last updated -731TypeScript