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!