basic mcp

The goal of this is just to write a simple MCP server with a handful of tools that can be plugged in to a local LLM.

It's just for experimentation but also straightforward enough to be human-readable (for those trying to learn)

Learning

In src/basic_mcp/main.py you see how straightforward it is to make an MCP server with FastMCP. It's just calling something, and the pandoc comments are what are given to the LLM.

Note that MCP servers are (in some way) just polite suggestions of text to LLMs, so without the comments here it actually won't work (or will work many orders of magnitude worse).

In src/basic_mcp/tools/web_tools.py there's a simple 'fetch article' tool. This is just so I have a placeholder/structure for extra tools as they're needed

install

As with everything, you should set this up in a virtualenv.

Then it's just a pip install -e .

running

cd src/basic_mcp && python main.py

uvx

This can be called with uvx --from /path/to/basic-mcp/ basic-mcp if it needs to be launched that way (for example with Jan)

Also note/remember that if it's in a virtualenv, uvx should be called with the full path name from within the virtualenv's bin.

Output

Note that the output is stdio and not a web server. This can be changed simply enough inside the main function and removing the transport variable parameter. Then it will default to being a web server