mcp-servers 0.1.0

Simple MCP Server Collection, Packaged

mcp_servers

A collection of MCP servers

Disclaimer

This project is created for personal use and does not guarantee stable behavior. It is made public solely as a reference for other programmers. The project is highly unstable, premature, and may produce undesired outcomes, so use it at your own risk.

Development Setup

git clone [e-mail]:assagman/mcp_servers.git

cd mcp_servers

uv venv --python 3.12 && source .venv/bin/activate

uv sync --extra dev

Examples

All LLM models are used from openrouter.ai, so on OPENROUTER_API_KEY env var is mandatory for this project to interact with a LLM model.

cp ./examples/.env.example ./examples/.env then set your OPENROUTER_API_KEY in ./examples/.env. In these examples google/gemini-2.5-flash-preview is picked as the LLM model since it's the best fit model for this workflow I experienced. You need to buy credits on https://openrouter.ai/settings/credits to experiment. Even some free alternatives can work sometimes, but either they do not produce consistent outputs or there are some problems with thi hosting server like rate limits or unavailability. Make sure you select models with tools usage. Generally Google and OpenAI models, even with smaller/cheaper ones, works well.

Example usage: as a package in client code

python examples/run_filesystem_agent.py

without making any changes, this command should be executed successfully as is, and it'll operate on a temporary directory.

Example usage: as a separate, dedicated MCP server

mcpserver start --server filesystem --port 8765 --allowed-dir $(pwd) --detach

Above command should start MCP server for filesystem in the background process. ps aux | rg mcpserver is expected to show this related process.

python examples/run_filesystem_agent_2.py

after some experimentation, please run:

mcpserver stop --server filesystem

This specific example uses CLI app utility to start/stop MCP seperately from the client code (different from the first example).