lukedev45/1st-MCP-server

fastMCP

fastMCP — a lightweight, high-performance Model Context Protocol (MCP) server built with fastmcp.
Designed to host tools and services for AI assistants (e.g., code-assistants, runtime helpers) and to interoperate with MCP inspectors and clients.

NOTE: This README was prepared without direct access to the repository. If you want it tuned to the exact repo structure, paste package.json, pyproject.toml, or key source files and I’ll update it.

---

Table of contents

• What is fastMCP?
• Features
• Quick start
• Configuration
• Run locally (development)
• Docker
• Usage examples
• Testing
• Contributing
• License

---

What is fastMCP?

fastMCP is an MCP server scaffold focused on speed and simplicity. It exposes a small set of tools and services over the Model Context Protocol so AI assistants or inspector tools can discover and use them. Typical uses include:

• Serving code-analysis and code-execution tools for code-assistant integrations.
• Exposing runtime helpers (e.g., project introspection, docs-indexing).
• Local/CI testing and prototyping of MCP-based assistants.

---

Features

• Minimal, dependency-light MCP server implementation.
• Tool registration and discovery endpoints.
• Integration-ready for inspector tools (e.g., @modelcontextprotocol/inspector).
• Configuration via environment variables or .env.
• Optional TLS support for secure deployments.
• Dockerfile and development convenience scripts.

---

Quick start

Requirements: Python 3.10+ (or Node version if your server is in Node), pip / poetry or npm / pnpm depending on implementation.

1. Clone the repo

   git clone https://github.com/lukedev45/fastMCP.git
   cd fastMCP
   
   

2. Create a virtual environment and activate it

python -m venv .venv
source .venv/bin/activate

3. Install dependencies

   pip install -r requirements.txt
   

4. Run the server

   uvicorn fastmcp.app:app --host 0.0.0.0 --port 8080 --reload