MCP Server Deployment Demo
This project is a demonstration of how to create and deploy a simple server that adheres to the Model-Context-Protocol (MCP). It provides a basic tool that can be called by an MCP client, such as an AI model like Claude.
Overview
The Model-Context-Protocol (MCP) is a specification for communication between a large language model (or other AI agent) and a local development environment. It allows the model to access local context and execute tools securely.
This project implements a simple MCP server using the mcp
Python library. The server exposes a single tool, add
, which takes two integers and returns their sum.
Features
- A simple
FastMCP
server implementation. - A basic
add(x: int, y: int) -> int
tool. - Packaged as a Python project using
pyproject.toml
andsetuptools
. - Ready for installation and deployment.
Project Structure
pyproject.toml
: Defines project metadata, dependencies, and build configuration. The[project.scripts]
section defines themcp-server
command.src/mcpserver/deployment.py
: Contains the core logic for the MCP server, including the definition of theadd
tool.src/mcpserver/__main__.py
: Provides the main entry point to run the server from the command line.
Getting Started
Prerequisites
- Python 3.12+
- uv (a fast Python package installer and resolver)
Installation
- Clone the repository:
- Install dependencies:
Create a virtual environment and install the project in editable mode.
Running the Server
Once installed, you can run the MCP server using the script defined in pyproject.toml
:
Claude Integration
To use this server as an MCP host for a client like Claude, you need to update your Claude configuration file (claude-config.json
). Add the following entry to the mcpHosts
section.
This configuration tells the Claude client how to launch and communicate with your MCP server. It uses uvx
to run the server directly from the Git repository, ensuring you are always using the latest version.
Note: Make sure to replace the command
and directory
paths with the correct absolute paths for your system.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
A demonstration MCP server that provides a simple addition tool for learning how to create and deploy servers following the Model-Context-Protocol specification. Serves as a basic example for developers getting started with MCP server development.