My MCP Servers 🛠

Intro & Links

The Model Context Protocol (MCP) serves tools and agents in the same way that REST APIs serve applications. It enables standardized integration and communication.

MCP enables seamless integration between:

• MCP Servers (Tools) - Like getting weather data
• MCP Clients (Agents & Apps) - Like OpenWebUI

Think of MCP servers as wrappers around tools that make them instantly usable by AI applications.

Essential Links 🔗

• MCP Server Quickstart Tutorial
• Quickstart Example Repo
• Official MCP Servers
• Create MCP Server Template

Getting Started

Checkout the add-note example server to get started.

Development Guide 🧑‍💻

Creating a New Server

1. Setup Structure

   export MY_SERVER="my-server-name"
   uvx create-mcp-server --name $MY_SERVER --path ./servers/$MY_SERVER
   

2. Install Dependencies

   cd ./servers/$MY_SERVER
   uv sync --dev --all-extras
   cd ../..
   

Running Locally

export MY_SERVER="my-server-name"
cd ./servers/$MY_SERVER && uv run $MY_SERVER

Development Tools

Monitor your MCP server during development using the official MCP Inspector tool:

export MY_SERVER="my-server-name"
npx @modelcontextprotocol/inspector uv --directory ./servers run $MY_SERVER

Building (Optional)

cd ./servers/$MY_SERVER
uv sync
uv build
cd ../..

Cleanup

To remove a server:

1. Delete the server entry from them members in pyproject.toml.
2. Run:

   rm -r ./servers/$MY_SERVER
   uv sync