Skip to main content
Glama

FastMCP Multi-Tool Server

by rt0120-Ramco
GitHub
Python
  • Apple
  • Linux
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

FastMCP Multi-Tool Server

A comprehensive Model Context Protocol (MCP) server built with FastMCP that provides various utility tools.

Features

This MCP server includes the following tools:

🕒 Time & Date

  • get_current_time: Get the current date and time

🌤️ Weather

  • get_weather: Get weather information for any city (requires OpenWeatherMap API key)

📁 File Operations

  • create_file: Create new files with specified content

  • read_file: Read content from existing files

  • list_directory: List contents of directories

  • create_temporary_file: Create temporary files

🔍 Search & Analysis

  • search_files: Search for text patterns in files within a directory

  • calculate_expression: Safely evaluate mathematical expressions

💻 System Operations

  • execute_command: Execute shell commands safely (with security restrictions)

  • get_system_info: Get detailed system information (CPU, memory, disk usage)

Installation

  1. Install Python dependencies:

pip install -r requirements.txt

  1. (Optional) Configure environment variables:

# Copy the example environment file cp .env.example .env # Edit .env and add your OpenWeatherMap API key if needed

Usage

Running the Server

To run the MCP server:

python server.py

The server will start and listen for MCP connections.

Configuration with Claude Desktop

To use this server with Claude Desktop, add the following configuration to your claude_desktop_config.json:

{ "mcpServers": { "multi-tool-server": { "command": "python", "args": ["C:/github/mcp-py/server.py"], "cwd": "C:/github/mcp-py" } } }

Note: Update the paths to match your actual installation directory.

Configuration File Location

The Claude Desktop configuration file is typically located at:

  • Windows: %APPDATA%/Claude/claude_desktop_config.json

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

Tool Examples

File Operations

# Create a new file create_file("./example.txt", "Hello, World!") # Read a file read_file("./example.txt") # List directory contents list_directory("./")

Weather Information

# Get weather for a city (requires API key) get_weather("London")

Mathematical Calculations

# Calculate mathematical expressions calculate_expression("2 + 2 * 3") calculate_expression("sqrt(16) + pow(2, 3)")

File Search

# Search for text in Python files search_files("./", "import", ".py")

System Information

# Get system details get_system_info()

Command Execution

# Execute safe commands execute_command("echo Hello World") execute_command("ls -la", "/tmp") # Unix execute_command("dir", "C:\\") # Windows

Security Features

  • Command Filtering: Dangerous commands are blocked automatically

  • Safe Expression Evaluation: Mathematical expressions are evaluated in a secure environment

  • Timeout Protection: Commands have a 30-second timeout limit

  • Path Validation: File operations validate paths to prevent unauthorized access

Environment Variables

  • OPENWEATHER_API_KEY: Your OpenWeatherMap API key for weather functionality

  • MCP_SERVER_NAME: Custom server name (optional)

  • MCP_SERVER_VERSION: Server version (optional)

Dependencies

  • fastmcp: FastMCP framework for MCP server development

  • requests: HTTP library for API calls

  • python-dotenv: Environment variable management

  • pydantic: Data validation and settings management

  • psutil: System and process utilities

Troubleshooting

Common Issues

  1. Import Errors: Make sure all dependencies are installed:

    pip install -r requirements.txt

  2. Weather Tool Not Working: Ensure you have a valid OpenWeatherMap API key set in the .env file.

  3. Permission Errors: Make sure the server has appropriate file system permissions for the operations you're trying to perform.

  4. Command Execution Fails: Some commands may be blocked for security reasons. Check the error message for details.

Development

To extend this server with additional tools:

  1. Add new tool functions using the @mcp.tool() decorator

  2. Follow the existing pattern for error handling and return formats

  3. Update this README with documentation for new tools

License

This project is open source. Feel free to modify and distribute according to your needs.

This server cannot be installed

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

Provides comprehensive utility tools including file operations, weather information, system monitoring, mathematical calculations, text search, and safe command execution. Enables users to perform various system and data operations through a unified MCP interface with built-in security features.

  1. Features
    1. 🕒 Time & Date
    2. 🌤️ Weather
    3. 📁 File Operations
    4. 🔍 Search & Analysis
    5. 💻 System Operations
  2. Installation
    1. Usage
      1. Running the Server
      2. Configuration with Claude Desktop
      3. Configuration File Location
    2. Tool Examples
      1. File Operations
      2. Weather Information
      3. Mathematical Calculations
      4. File Search
      5. System Information
      6. Command Execution
    3. Security Features
      1. Environment Variables
        1. Dependencies
          1. Troubleshooting
            1. Common Issues
          2. Development
            1. License

              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/rt0120-Ramco/mcp-py'

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