Skip to main content
Glama
mcp_local_server

mcp_local_server

MCP Local Server

A local Model Context Protocol (MCP) server built with FastMCP, designed to run and serve MCP-compatible tools locally.

πŸ“‹ Overview

This project provides a lightweight, local MCP server implementation that allows you to expose custom tools and resources to MCP-compatible clients (such as Claude Desktop) for local development and testing.

Related MCP server: Basic MCP

✨ Features

  • πŸš€ Fast and lightweight local MCP server

  • πŸ”Œ Easy integration with MCP-compatible clients

  • πŸ› οΈ Built on top of FastMCP for rapid tool development

  • πŸ“¦ Simple dependency management with uv

🧰 Requirements

  • Python >= 3.14

  • uv (recommended for dependency management)

πŸ“¦ Installation

Clone the repository:

git clone https://github.com/sarthakdeshmukh0770-jpg/mcp_local_server.git
cd mcp_local_server

Install dependencies using uv:

uv sync

πŸš€ Usage

Run the server locally:

uv run main.py

πŸ—‚οΈ Project Structure

mcp_local_server/
β”œβ”€β”€ main.py            # Entry point for the MCP server
β”œβ”€β”€ test.py             # Test cases
β”œβ”€β”€ expenses.db          # Local database (example use case)
β”œβ”€β”€ pyproject.toml        # Project metadata and dependencies
β”œβ”€β”€ uv.lock             # Locked dependency versions
└── README.md            # Project documentation

πŸ§ͺ Testing

Run the test suite:

uv run pytest test.py

🀝 Contributing

Contributions, issues, and feature requests are welcome. Feel free to check the issues page.

πŸ“„ License

This project is currently unlicensed. Add a license file if you plan to open source this project.

πŸ‘€ Author

Sarthak Deshmukh πŸ“§ sarthakdeshmukh0770@gmail.com

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A lightweight framework for building and running Model Context Protocol (MCP) servers using FastMCP, providing tools for development, debugging, and server management.
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A simple MCP server built with FastMCP for experimentation and learning purposes. Includes basic web tools like article fetching and serves as a human-readable template for building custom MCP servers.
      AGPL 3.0
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      A basic MCP server built with FastMCP framework that provides example tools including message echoing and server information retrieval. Supports both stdio and HTTP transports for integration with various MCP clients.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A simple demonstration MCP server that provides an echo tool and resource for learning how to build MCP servers. Serves as a starting point and template for creating custom MCP server implementations.
      1
      -