Skip to main content
Glama

MCP Multi-Tool Server

by vipankumar87
GitHub
Python
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

  • uv package manager

Installation

  1. Clone the repository

    git clone <your-repo-url> cd mcp-multi-tool-server

  2. Install dependencies

    uv sync

  3. 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\VipanKumar\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

  1. Calculator Tools: Use MCP Inspector to call each tool with test parameters

  2. Resource Access: Check the resource tab in MCP Inspector for file://typesdk

  3. Prompt Templates: Test the meeting_summary prompt 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 uv installation: 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_PATH points to correct file

  • Check file permissions

  • Ensure file exists and is readable

Prompt template errors:

  • Verify templates/Prompt.md exists

  • Check template syntax

  • Ensure proper variable placeholders: {{ variable_name }}

Debug Mode

Run with debug output:

uv run python server.py --debug

Contributing

  1. Fork the repository

  2. Create a feature branch: git checkout -b feature-name

  3. Make your changes

  4. Add tests for new functionality

  5. 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.

Deploy Server
-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

Provides calculator tools for mathematical operations, document resources for accessing TypeScript SDK documentation, and prompt templates for generating structured meeting summaries. Built with FastMCP to demonstrate comprehensive MCP capabilities including tools, resources, and prompts in a single implementation.

  1. Features
    1. šŸ§® Calculator Tools
    2. šŸ“– Document Resources
    3. šŸ“ Prompt Templates
  2. Quick Start
    1. Prerequisites
    2. Installation
  3. Usage
    1. Calculator Tools
    2. TypeScript SDK Resource
    3. Meeting Summary Prompt
  4. Claude Desktop Integration
    1. Configuration
    2. Restart Claude Desktop
  5. Development
    1. Project Structure
    2. Testing
    3. Customization
  6. Error Handling
    1. Configuration Options
      1. File Paths
      2. Server Name
    2. Troubleshooting
      1. Common Issues
      2. Debug Mode
    3. Contributing
      1. License
        1. Resources

          New MCP Servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/vipankumar87/MCP-Example'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server