falcon-mcp-server

Table of Contents

• Installation
• Example Usage
• License

Installation

Install from PyPI:

pip install falcon-mcp-server[serve]

This is a fast-moving project in its early stages where new versions are not always immediately released to PyPI. To install directly from the main branch:

pip install git+https://github.com/falconry/falcon-mcp-server

Example Usage

See the example in example/example.py.

Change dir to example/, and run with Uvicorn:

uvicorn --log-config logging.yaml --factory example:mcp.create_app

Connect with any AI agent or MCP inspector supporting the latest Streamable HTTP transport version.

For instance, assuming you have both MCPHost and Ollama installed on your system, you can run it against the previously started server (see above) as:

mcphost --config mcphost.yaml -m ollama:granite4:3b --prompt "What is the current temperature in London?"

Omit --prompt to run interactively. Feel free to pull and use a different ollama model!

License

falcon-mcp-server is distributed under the terms of the Apache-2.0 license.