Modular MCP Server with Python Tools

# Modular MCP Server with Python Tools This project is a **test/demo** implementation to understand how to build a modular MCP (Model Context Protocol) server in Python, integrate custom tools, and use prompts to interact with language models. --- ## Purpose - Explore **Python async programming** and tool registration with MCP. - Practice building tools that can be invoked via chat input (e.g., note creation, searching, running commands). - Experiment with **prompt design** and using local LLMs (via Ollama) to parse natural language into structured commands. - Understand how to **detect user intents** from free text and map them to specific tools. - Learn how to handle tool invocation responses asynchronously and display results. --- ## Features - Tool examples: - Note creation and search with SQLite backend. - Weather fetching. - Mathematical calculation. - Time queries. - Running shell commands safely. - File operations. - Intent detection via keyword matching and prompt parsing. - Ollama local LLM integration for structured data extraction. - Modular design allowing easy addition of new tools. --- ## Usage - Start the MCP server (e.g., `python simple_modular_server.py`). - Run the client script to chat and interact with tools. - Use natural language commands like: - `"make a note. title is shopping list. category groceries."` - `"search note groceries"` - `"run command 'pwd'"` - `"what's the weather in London?"` --- ## Notes - This project is purely for learning and testing. - It is not production-ready. - Designed to help understand MCP architecture, Python tooling, and prompt engineering with local LLMs. --- ## Requirements - Python 3.8+ - Ollama installed and running locally with your preferred models (e.g., `phi`, `llama3.2:3b`). - SQLite (built-in with Python). - Dependencies listed in `requirements.txt` (if created). --- ## License This is an educational project with no license. --- Feel free to experiment and extend!