Slim MCP

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)

Setup with 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

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)

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

Restart the server and your new tool is ready to use!

👥 Contributing

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

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

📄 License

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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

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

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.

Related Resources

Reddit Discussion about this server

Related MCP Servers

CbetaMCP
tendayspace
-
security
A
license
-
quality
A modular, extensible FastAPI-based platform that aggregates multiple AI tools and microservices into a unified interface with standardized I/O formats, perfect for frontend integration or LLM system orchestration.
Last updated 4 months ago
2
Python
MIT License
XiaoZhi MCP Aggregate
avxxoo
-
security
F
license
-
quality
A powerful interface for extending AI capabilities through remote control, calculations, email operations, knowledge search, and more.
Last updated 19 days ago
34
Python
MCP Weather Server
ramonbnuezjr
-
security
F
license
-
quality
A standardized API server that enables AI agents and client applications to fetch current weather information for any location without directly interacting with external weather APIs.
Last updated 2 months ago
Python
MCP Server for Apache Airflow
tomnagengast
-
security
A
license
-
quality
Provides integration with Apache Airflow's REST API, allowing AI assistants to programmatically interact with Airflow workflows, monitor DAG runs, and manage tasks.
Last updated 2 months ago
JavaScript
MIT License

View all related MCP servers