foss42/mcp

Open Source foss42 MCP Server

About mcp

An MCP server exposing the foss42 utilities — country data, text and case conversion, and human-friendly number and date formatting.

Built with FastMCP. 5 workflow-shaped tools, no API key, no network calls — everything runs locally against bundled data.

See DESIGN.md for the reasoning and measured before/after.

- Quick start - Connecting a client - Tools - Errors - Development

Run over stdio (the default, for local clients such as Claude Code or Claude Desktop):

Or over streamable HTTP, for a remotely reachable server:

Flag Default Description --- --- --- --transport stdio stdio or http --host 127.0.0.1 Bind address (http only) --port 8000 Bind port (http only)

To try the tools by hand, see TESTING.md.

Claude Desktop — add to claudedesktopconfig.json:

Use absolute paths, and point at the venv's interpreter rather than a bare python.

All five tools are annotated readOnlyHint, idempotentHint, destructiveHint: false and openWorldHint: false, so clients can skip confirmation prompts.

Look up one or more countries and return only the fields you ask for.

country takes a name, alias, or ISO alpha-2/alpha-3 code. You never need to know the code. Pass a list to look up several at once.

Resolution is forgiving: diacritics, punctuation and the definite article are normalised (Türkiye, Turkiye, U.S.A., The Netherlands), historical and colloquial names resolve (Burma → Myanmar, Swaziland → Eswatini, Holland → Netherlands, Great Britain → GB), and an ambiguous input is reported rather than guessed:

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/foss42--mcp.html)

Related MCP servers