mcf-server

Create an MCP server for: $ARGUMENTS

Language Decision

Ask the user which language unless obvious from context:

• Python (FastMCP 2.x) — Default choice. 20 existing examples in mcp-servers/python/. Best for rapid development, API integrations, and data processing.
• Go (mcp-go) — 6 existing examples in mcp-servers/go/. Best for high-performance, low-latency, or standalone binary deployments.

Python Server (FastMCP 2.x)

Project Layout

mcp-servers/python/<server-name>/
  pyproject.toml
  Makefile
  Containerfile
  README.md
  src/<package_name>/
    __init__.py
    server_fastmcp.py   # FastMCP entry point
    tools.py             # optional: separate tool logic
  tests/
    test_server.py

Step 1: Scaffold the project

Use the naming convention: kebab-case for directory, snake_case for package.

# Example: mcp-servers/python/weather-server/src/weather_server/
mkdir -p mcp-servers/python/<server-name>/src/<package_name>
mkdir -p mcp-servers/python/<server-name>/tests
touch mcp-servers/python/<server-name>/src/<package_name>/__init__.py

Step 2: Create server_fastmcp.py

Follow this pattern (all 20 existing servers use it):

# -*- coding: utf-8 -*-
from fastmcp import FastMCP
import argparse

mcp = FastMCP("<server-name>", version="0.1.0")


@mcp.tool
def my_tool(param: str) -> str:
    """Tool description — type hints define the MCP schema."""
    return f"Result: {param}"


def main() -> None:
    """Entry point with transport selection."""
    parser = argparse.ArgumentParser(description="<Server Name> FastMCP Server")
    parser.add_argument("--transport", choices=["stdio", "http"], default="stdio")
    parser.add_argument("--host", default="0.0.0.0")
    parser.add_argument("--port", type=int, default=8000)
    args = parser.parse_args()

    if args.transport == "http":
        mcp.run(transport="http", host=args.host, port=args.port)
    else:
        mcp.run()


if __name__ == "__main__":
    main()