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