Slim MCP

by webdevtodayjason
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • The MCP server project is hosted on GitHub, allowing users to clone the repository, contribute via pull requests, and star the project

  • Built on Python 3.11+ and provides an extensible framework for creating custom Python-based tools for Claude

Slim-MCP: Claude Tools šŸ¤–

šŸš€ Supercharge Claude with powerful Python-based tools via the MCP protocol

āœØ Features

  • šŸ§® Calculator: Perform complex math calculations
  • šŸŒ¦ļø Weather: Get current weather forecasts and alerts
  • šŸ•’ DateTime: Access current time in local and UTC formats
  • šŸ”Œ Extensible: Easily add custom tools with simple Python functions
  • šŸ’» Desktop Integration: Seamless integration with Claude Desktop app
  • šŸ–±ļø Cursor IDE: Native integration with Cursor IDE for developers

šŸ“‹ Table of Contents

šŸš€ Installation

Prerequisites

  • Python 3.11+
  • Conda (recommended)
# Create conda environment with Python 3.11 conda create -n mcp-tools python=3.11 # Activate environment conda activate mcp-tools # Clone the repository git clone https://github.com/webdevtodayjason/slim-MCP.git cd slim-MCP # Install with uv (preferred) uv pip install -e . # OR install with standard pip pip install -e .

šŸŽ® Usage

Configure Claude

Add this to your Claude configuration file:

{ "mcpServers": { "claude-tools": { "command": "/path/to/conda/envs/mcp-tools/bin/python", "args": ["-m", "claude_tools.main"] } } }

Configure Cursor IDE

NAME: claude-tools TYPE: command COMMAND: /path/to/conda/envs/mcp-tools/bin/python -m claude_tools.main

Example Prompts

Can you calculate 25^3 + sqrt(196)? What's the current time in UTC? What's the weather like in Austin, TX?

šŸ”Œ Integrations

  • Claude AI Desktop: Primary integration via MCP protocol
  • Cursor IDE: Direct integration for development workflows
  • Claude Web: Compatible with Claude Web through configuration

šŸ’» Development

Project Structure

slim-MCP/ ā”œā”€ā”€ src/ ā”‚ ā””ā”€ā”€ claude_tools/ ā”‚ ā”œā”€ā”€ __init__.py ā”‚ ā”œā”€ā”€ calculator.py # Math calculation tool ā”‚ ā”œā”€ā”€ datetime_tool.py # Date and time utilities ā”‚ ā”œā”€ā”€ main.py # Entry point ā”‚ ā””ā”€ā”€ weather.py # Weather forecasting tool ā”œā”€ā”€ http_server.py # HTTP server for MCP ā”œā”€ā”€ pyproject.toml # Project configuration ā”œā”€ā”€ .gitignore # Git ignore file ā””ā”€ā”€ LICENSE # MIT License

Creating a New Tool

  1. Create a new Python file in src/claude_tools/:
# src/claude_tools/my_tool.py def my_awesome_function(param: str) -> str: """Description of what this tool does. Args: param: Description of the parameter Returns: A string with the result """ result = f"Processed: {param}" return result def register_my_tools(mcp): """Register all my tools with the MCP server.""" mcp.tool()(my_awesome_function)
  1. Import and register your tool in __init__.py:
# In src/claude_tools/__init__.py from .calculator import register_calculator_tools from .datetime_tool import register_datetime_tools from .weather import register_weather_tools from .my_tool import register_my_tools # Add this line def register_all_tools(mcp): register_calculator_tools(mcp) register_datetime_tools(mcp) register_weather_tools(mcp) register_my_tools(mcp) # Add this line
  1. Restart the server and your new tool is ready to use!

šŸ‘„ Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

šŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


-
security - not tested
A
license - permissive license
-
quality - not tested

A lightweight, modular API service that provides useful tools like weather, date/time, calculator, search, email, and task management through a RESTful interface, designed for integration with AI agents and automated workflows.

  1. āœØ Features
    1. šŸ“‹ Table of Contents
      1. šŸš€ Installation
        1. Prerequisites
          1. Setup with Conda (Recommended)
          2. šŸŽ® Usage
            1. Configure Claude
              1. Configure Cursor IDE
                1. Example Prompts
                2. šŸ”Œ Integrations
                  1. šŸ’» Development
                    1. Project Structure
                      1. Creating a New Tool
                      2. šŸ‘„ Contributing
                        1. šŸ“„ License