MCP Multi-Tool Server
A comprehensive Model Context Protocol (MCP) server built with FastMCP that provides calculator tools, document resources, and prompt templates. This server demonstrates multiple MCP capabilities including tools, resources, and prompts in a single implementation.
Features
🧮 Calculator Tools
- Basic Operations: Addition, subtraction, multiplication, division
- Advanced Math: Power, square root, factorial calculations
- Utility Functions: Percentage calculations
- Error Handling: Division by zero protection, negative square root protection, factorial range limits
📖 Document Resources
- TypeScript SDK Resource: Access to MCP TypeScript SDK documentation
- Dynamic File Reading: Reads from configurable file paths
- Error Handling: Graceful handling of missing files
📝 Prompt Templates
- Meeting Summary Template: Executive meeting summary generator
- Variable Substitution: Dynamic template variable replacement
- Structured Output: Professional meeting summary format
Quick Start
Prerequisites
- Python 3.12 or later
uvpackage manager
Installation
-
Clone the repository
git clone <your-repo-url> cd mcp-multi-tool-server
-
Install dependencies
uv sync -
Test the server
uv run mcp dev server.py
Open http://localhost:3000 to test the server in MCP Inspector.
Usage
Calculator Tools
The server provides 8 calculator tools:
| Tool | Description | Example |
|---|---|---|
add |
Add two numbers | add(5, 3) → 8 |
subtract |
Subtract second from first | subtract(10, 4) → 6 |
multiply |
Multiply two numbers | multiply(6, 7) → 42 |
divide |
Divide first by second | divide(15, 3) → 5 |
power |
Raise to power | power(2, 8) → 256 |
square_root |
Calculate square root | square_root(16) → 4 |
factorial |
Calculate factorial | factorial(5) → 120 |
calculate_percentage |
Calculate percentage | calculate_percentage(200, 15) → 30 |
TypeScript SDK Resource
Access the TypeScript SDK documentation:
# Resource URI: file://typesdk
# Returns the contents of the TypeScript SDK documentation
Configuration: Update DESKTOP_FILE_PATH in server.py to point to your documentation file:
DESKTOP_FILE_PATH = r"C:\Users\Arnold\Desktop\typesdk.md"
Meeting Summary Prompt
Generate structured meeting summaries:
# Prompt: meeting_summary
# Required parameters:
# - meeting_date: Date of the meeting
# - meeting_title: Title or purpose of the meeting
# - transcript: Meeting transcript or notes
Output Structure:
- Overview (purpose, participants, topics)
- Key Decisions (major decisions, strategic changes)
- Action Items (next steps, responsibilities, deadlines)
- Follow-up Required (pending discussions, future meetings)
Claude Desktop Integration
Configuration
Add to your Claude Desktop config file:
Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"multi-tool-server": {
"command": "uv",
"args": [
"--directory",
"/path/to/your/server/directory",
"run",
"python",
"server.py"
],
"env": {
"UV_PROJECT_ENVIRONMENT": ".venv"
}
}
}
}
Restart Claude Desktop
After updating the configuration, restart Claude Desktop to load the server.
Development
Project Structure
mcp-multi-tool-server/
├── server.py # Main server implementation
├── templates/
│ └── Prompt.md # Meeting summary template
├── pyproject.toml # Project configuration
├── claude_desktop_config.json # Claude Desktop config example
├── README.md # This file
└── .venv/ # Virtual environment
Testing
MCP Inspector (Recommended)
uv run mcp dev server.py
Direct Server Testing
python server.py
Testing Individual Components
- Calculator Tools: Use MCP Inspector to call each tool with test parameters
- Resource Access: Check the resource tab in MCP Inspector for
file://typesdk - Prompt Templates: Test the
meeting_summaryprompt with sample data
Customization
Adding New Calculator Tools:
@mcp.tool()
def new_calculation(param1: float, param2: float) -> float:
"""Description of the new calculation."""
return param1 + param2 # Your calculation logic
Adding New Resources:
@mcp.resource("file://your-resource")
async def get_your_resource() -> str:
"""Description of your resource."""
# Your resource logic
return "Resource content"
Adding New Prompts:
@mcp.prompt("your_prompt")
async def your_prompt(param1: str, param2: str) -> str:
"""Description of your prompt."""
# Your prompt logic
return f"Processed: {param1}, {param2}"
Error Handling
The server includes comprehensive error handling:
- Division by Zero: Returns appropriate error message
- Negative Square Roots: Prevents invalid operations
- Factorial Limits: Restricts calculations to reasonable ranges (n ≤ 100)
- File Not Found: Graceful handling of missing resource files
- Template Errors: Proper error reporting for prompt template issues
Configuration Options
File Paths
Update these paths in server.py for your environment:
# TypeScript SDK documentation path
DESKTOP_FILE_PATH = r"C:\Users\YourUser\Desktop\typesdk.md"
# Prompt template path (relative to server.py)
PROMPT_TEMPLATE_PATH = os.path.join(os.path.dirname(__file__), "templates", "Prompt.md")
Server Name
Change the server name in server.py:
mcp = FastMCP("Your Server Name")
Troubleshooting
Common Issues
Server won't start:
- Check Python version (3.12+ required)
- Verify
uvinstallation:uv --version - Check virtual environment:
uv sync
Tools not appearing in Claude:
- Verify Claude Desktop config file location
- Check file paths in configuration
- Restart Claude Desktop after config changes
Resource file not found:
- Verify
DESKTOP_FILE_PATHpoints to correct file - Check file permissions
- Ensure file exists and is readable
Prompt template errors:
- Verify
templates/Prompt.mdexists - Check template syntax
- Ensure proper variable placeholders:
{{ variable_name }}
Debug Mode
Run with debug output:
uv run python server.py --debug
Contributing
- Fork the repository
- Create a feature branch:
git checkout -b feature-name - Make your changes
- Add tests for new functionality
- Submit a pull request
License
This project is licensed under the MIT License. See LICENSE file for details.
Resources
Built with FastMCP - A high-level Python library for building MCP servers.
Metadata
Release files for iflow-mcp_arnie936-mcp-server-course 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_arnie936_mcp_server_course-0.1.0.tar.gz | 17.9 kB | Without provenance | Details for iflow_mcp_arnie936_mcp_server_course-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_arnie936_mcp_server_course-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_arnie936_mcp_server_course-0.1.0-py3-none-any.whl |
Total release size: 47.9 kB
Release files / iflow_mcp_arnie936_mcp_server_course-0.1.0.tar.gz
| Download URL | iflow_mcp_arnie936_mcp_server_course-0.1.0.tar.gz |
|---|---|
| Size | 17.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2bba56d409a2af00d79b81b03ba09437acafc47a766744adccb43deacdff22a1
|
|
BLAKE2b-256 checksum How to use checksums |
4dc6ae64a82de3435194dfd10bb7c660ff1cf1f0a78eef412ff663ef1dd76367
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_arnie936_mcp_server_course-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_arnie936_mcp_server_course-0.1.0-py3-none-any.whl |
|---|---|
| Size | 30.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b1a57c144adf8ea15f76a2872b715308830d23beea3b61fc0fdc9e50f0ff0d3b
|
|
BLAKE2b-256 checksum How to use checksums |
dd5d4286a88fff9ca031220482d1867de25ca940c4f5a03a9b46232b4811df27
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_arnie936-mcp-server-course 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.