DEMO Country MCP Server

A modular MCP server exposing tools for country and state lookups. Ready for use as a CLI or plug-in agent.

Quick Start

1. Clone and set up your environment

   git clone <REPO_URL> cd mcp-server

2. Build the package

   python -m build

3. Install globally with pipx

   pipx install dist/country_mcp_server-*.whl --force

4. Run the server

   country-mcp-server

   Or, for development with Inspector UI:

   mcp dev country_server_mcp/main.py

Add Your Own Tools

• Put new modules in country_server_mcp/tools/.

• Each module should define a register(mcp) function and add tools using @mcp.tool().

• Import and call each new tool's register(mcp) in main.py.

• Rebuild and reinstall with pipx install dist/… --force.

Example Project Layout

country_server_mcp/
    __init__.py
    main.py
    tools/
        __init__.py
        countries.py
        states.py
pyproject.toml
README.md

Use as an MCP agent

Add to your orchestrator config:

{
  "mcpServers": {
    "country": {
      "command": "country-mcp-server",
      "args": []
    }
  }
}

Notes

• If you update tools, rebuild and reinstall the package.

• Make sure your CLI binary is in your PATH (~/.local/bin for pipx by default).

• For dev mode, editable install: pip install -e .

Let me know if you want it even more minimal or need a specific “getting started” blurb for a team!