Overview
What is BasicMcpServer?
BasicMcpServer is a reference repository for implementing MCP (Model Context Protocol) servers. It provides a simple example MCP server, Docker containerization demo, and a setup script to generate a Jira-integrated MCP server, aimed at developers learning to build and deploy MCP servers.
How to use BasicMcpServer?
Users can clone the repository and modify src/server.py and config.py for custom tools and resources. They can also run the setup_jira_mcp_server.sh script with options like -n to specify project name, --no-git to skip Git initialization, and --no-github to skip GitHub creation. The server can be run with Docker or directly with Python.
Key features of BasicMcpServer
- Simple reference implementation with a basic tool
- Docker containerization with multi-stage builds
- End-to-end testing demonstrations
- Script to generate a Jira MCP server
- Comprehensive implementation guide in
mcp_server_implementation_guide.md - Customizable template for other services
Use cases of BasicMcpServer
- Learning how to build a minimal MCP server from scratch
- Setting up a containerized MCP server with Docker and testing
- Generating a ready-to-use Jira MCP server for AI assistant integration
- Using the Jira server as a template to create MCP servers for other APIs
- Understanding MCP server best practices through the included guide
FAQ from BasicMcpServer
What is MCP?
The Model Context Protocol (MCP) is a standard for communication between AI assistants and external services, enabling tool calling, resource access, and system interaction.
What are the prerequisites?
Python 3.11 or higher, Docker for containerized deployment, and service-specific API credentials (e.g., Jira credentials).
Can I use BasicMcpServer with services other than Jira?
Yes, the Jira MCP server can be used as a template; replace the service integration code in src/services/ and update configuration files.
How do I generate a Jira MCP server?
Run the script setup_jira_mcp_server.sh with optional flags for project name, git, and GitHub integration.
What documentation is included?
A comprehensive guide called mcp_server_implementation_guide.md covering project structure, FastMCP implementation, Docker, testing, deployment, and best practices.
