Skip to main content
Glama
Sign In
deenesjakoruzh
mcp-commune-france

mcp-commune-france

by Hug0x0
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

mcp-commune-france

MCP server for French commune intelligence: geo.api.gouv.fr, postal codes, departments, regions, and dataset discovery.

Tools

Run the MCP and call commune_france_get_sources first to inspect source coverage. This server also exposes domain-specific tools for the topic described above.

Includes commune resolution, department commune lists, commune profiles, BAN address geocoding, and address-to-commune profiles.

Related MCP server: mcp-data-gouv-fr

Install

npm install
npm run build
npm test
npm run dev

Claude Desktop

{
  "mcpServers": {
    "commune-france": {
      "command": "npx",
      "args": ["mcp-commune-france"]
    }
  }
}

Sources

Publishing

See docs/publishing.md.

Glama / Docker

The repo includes Dockerfile and glama.json.

Build steps:

["npm install", "npm run build"]

CMD arguments:

["node", "dist/index.js"]

Safety

This MCP helps agents discover and summarize public sources. It is not an official authority. Verify decisions against the competent public service or original data producer.

License

MIT

Available Tools

5 tools
commune_france_fetch_source_excerptB

Fetch a short text excerpt from a curated source by index or title keyword.

Inputs: source_key (required), max_chars.

commune_france_find_communeA

Resolve French communes by name, INSEE code, or postal code using geo.api.gouv.fr.

Inputs: query (required), limit.

commune_france_get_sourcesA

List curated sources used by this MCP.

Inputs: no named parameters.

commune_france_list_department_communesB

List communes in a French department using geo.api.gouv.fr.

Inputs: department_code (required).

commune_france_profileB

Build a source-oriented commune profile with geo identity and suggested public-data queries.

Inputs: code_insee (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.7/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a distinct purpose: source list, source excerpt, commune resolution, department listing, and profile building. No overlap exists between finding a specific commune and listing all communes in a department, and the profile combines earlier data without redundancy.

    Naming Consistency5/5

    All tools share the 'commune_france_' prefix and follow a verb_noun pattern (get, fetch, find, list, profile). The only deviation is 'profile' as a noun, but it functions as a verb-like action and remains uniform with the prefix, making the pattern predictable.

    Tool Count5/5

    Five tools is well within the optimal range for a focused server. Each tool covers a discrete part of the domain—sources and commune data—without unnecessary expansion or redundancy.

    Completeness5/5

    The server covers its stated purpose completely: retrieving source metadata, fetching excerpts, resolving communes, listing department communes, and building a composite profile. There are no obvious missing operations for a read-only, data-retrieval service.

    Maintenance

    ActivityActive
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • mcp-data-gouv-fr

      Hug0x0
      A
      license
      A
      quality
      B
      maintenance
      Enables discovery and inspection of French public open data on data.gouv.fr, including datasets, resources, organizations, and dataservices via natural language.
      9
      MIT

    • mcp-outremer

      Hug0x0
      A
      license
      A
      quality
      B
      maintenance
      Enables discovery and navigation of French overseas territories public data across national and local open-data portals, with tools to search datasets, list territories and communes, and fetch source excerpts via official French government APIs.
      10
      MIT

    • mcp-french-transport-data

      Hug0x0
      A
      license
      B
      quality
      B
      maintenance
      Enables discovery and summarization of public French transport data, including datasets, GTFS resources, regions, networks, and data-quality information, via transport.data.gouv.fr.
      5
      MIT