llanterme

Country MCP Server

by llanterme

開発ツール

A modular MCP server that provides tools for looking up country and state information. Designed as a demonstration of building extensible MCP servers with custom tool modules.

GitHubで見る

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

Clone and set up your environment

git clone <REPO_URL> cd mcp-server
Build the package

python -m build
Install globally with pipx

pipx install dist/country_mcp_server-*.whl --force
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!