Country MCP Server

# 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!