Skip to main content
Glama
cqtrinv

mcp-trinv-server

by cqtrinv

mcp-trinv-server, un serveur MCP pour TRINV

mcp-trinv-server (ou MCPTRINV) est un serveur de type MCP (Model Context Protocol) qui est utilisé pour augmenter les ressources d'assistant d'Intelligence Artificielle comme Claude ou Gemini.

MCPTRINV permet de rechercher des communes à partir d'un fragment de leur nom puis de rechercher des parcelles cadastrales dans une commune ayant une surface donnée. Il s'appuie sur le site TRINV.

Outils

  • trinv-chercher-commune: chercher des communes

  • trinv-chercher-parcelle: chercher des parcelles cadastrales

Related MCP server: IGN API Carto MCP Server

Installation

npm install mcp-trinv-server

Il faut ensuite déclarer ce serveur dans votre assistant ce qui dépend, entre autres, de l'assistant que vous utilisez, du système d'exploitation sur lequel vous êtes, du répertoire où vous êtes.

Installation dans Claude

Ajouter dans ~/.config/Claude/claude_desktop_config.json ou (sur Mac) dans ~/Library/'Application Support'/Claude/claude_desktop_config.json

{
    "mcpServers": {
        "trinv-server": {
            "command": "/usr/bin/node",
            "args": [
                ".../dist/index.js"]
        }
    }
}

Installation dans Gemini

Ajouter dans ~/.gemini/settings.json

{
    "mcpServers": {
        "trinv-server": {
            "command": "/usr/bin/node",
            "args": [
                ".../dist/index.js"]
        }
    }
}

Usage

Voici un exemple de conversation mené avec mcp-trinv-server et Claude.

Available Tools

2 tools
trinv-chercher-communeA

Cet outil permet de chercher des communes en France à partir d'un fragment de leur nom (c'est-à-dire une série de lettres consécutives). Ainsi, chercher BEURD conduit à trouver la commune de TREBEURDEN. Il faut cependant être spécifique car chercher, par exemple, SAINT mène à 4834 communes: un si grand nombre de résultats ne peut être listé ni utilement, ni agréablement.

Les communes trouvées sont accompagnées de leur code INSEE, de leurs coordonnées (latitude, longitude). Certaines communes ont changé de nom ou ont été regroupées avec d'autres.

Exemples de questions:

  • Quelle est la commune nommée BEURD ?

  • Dis-moi quelles sont les communes ayant DOUS dans leur nom ?

Pour en savoir plus

ParametersJSON Schema
NameRequiredDescriptionDefault
fragmentYes

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden. It discloses that results include INSEE code and coordinates, warns that large result sets may not be listed, and notes that some communes have changed names or merged. This is useful behavioral context beyond a simple 'search' statement.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise and well-structured, starting with the purpose, followed by usage advice, output details, and example questions. Every sentence adds valuable information, and the link to docs is a bonus.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (1 parameter, no output schema, no annotations), the description is complete. It covers parameter semantics, result contents, edge cases (name changes/mergers), and the practicality of result limits, leaving little ambiguity for an agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema provides zero description for the 'fragment' parameter, but the description thoroughly explains it as a series of consecutive letters from the commune name and gives concrete examples (BEURD → TREBEURDEN). This fully compensates for the missing schema description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool searches for French communes by a name fragment ('chercher des communes en France à partir d'un fragment de leur nom'). It is specific about the resource and method, but it does not explicitly mention the sibling tool trinv-chercher-parcelle, so it misses the top score for sibling differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives clear context and examples of when to use the tool (e.g., 'Quelle est la commune nommée BEURD ?'). It also provides an important usage warning about being specific to avoid huge result sets (SAINT → 4834 communes). However, it does not explicitly discuss exclusions or alternatives, staying a bit short of a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

trinv-chercher-parcelleB

Cet outil permet de rechercher des parcelles cadastrales ayant une certaine surface au sein d'une commune de France. Cette recherche s'effectue, le plus souvent, en deux phases:

  1. Spécifier la commune qui vous intéresse

  2. Indiquer la taille (en m²) de la parcelle recherchée.

Bien identifier la commune implique de connaître son code INSEE.

Exemples de questions:

  • Y a t-il une parcelle de surface 247 m² dans BEDOUS

  • Je cherche une parcelle dans BEURD faisant 333 m²

Pour en savoir plus

ParametersJSON Schema
NameRequiredDescriptionDefault
areaYes
fragmentYes

TDQS

B3.4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden. It discloses the typical two-step process and the prerequisite of knowing the INSEE code, which is useful behavioral context. It does not mention return behavior, error handling, or side effects, but for a search tool the disclosed information partially addresses transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured: a clear opening statement, a two-step numbered list, and two relevant examples. It is concise and front-loaded with the core purpose; the link and examples are useful without excessive bloat.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has no annotations or output schema, placing full responsibility on the description. It adequately covers the input process (commune and area) and necessary prerequisite (INSEE code), but it does not state what the tool returns, how results appear, or what happens when no matching parcel exists. For a search tool this is a significant but not fatal gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Since schema coverage is 0%, the description must provide meaning. It clarifies that 'area' is in square meters and that the other parameter relates to identifying the commune, but it leaves ambiguity about whether 'fragment' expects a commune name or INSEE code. The examples use names (BEDOUS, BEURD), while the text emphasizes the INSEE code, creating uncertainty.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly defines the tool as searching for cadastral parcels of a certain area within a French commune, with parameters for commune and area (in m²). It provides concrete example queries (e.g., 'Y a-t-il une parcelle de surface 247 m² dans BEDOUS'). It distinguishes from the sibling tool by focusing on parcels rather than communes, but does not explicitly name the alternative, so it falls short of full sibling differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description outlines a two-phase workflow (specify the commune, then the area) and stresses knowing the INSEE code, giving implied usage guidance. However, it does not explicitly state when to use this tool over the sibling 'trinv-chercher-commune' or provide exclusions, leaving the comparison implicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

TDQS

A3.9/5.0
Disambiguation5/5

The two tools have clearly distinct purposes: one searches for French communes by name fragment, the other searches for cadastral parcels by area within a commune. There is no overlap or ambiguity in their roles.

Naming Consistency5/5

Both tool names follow the same pattern: 'trinv-' prefix, 'chercher-' verb, and a specific object ('commune' or 'parcelle'). The naming is perfectly consistent and predictable.

Tool Count4/5

With only two tools, the server is slightly under the typical 3-15 range, but the narrow focus on commune and parcel search justifies the minimal count. The tools are well-scoped and each serves a distinct need.

Completeness4/5

The server covers the core search workflows for its domain: finding communes and then parcels within them. Minor gaps exist (e.g., no direct lookup by INSEE code), but the provided tools enable the primary use cases without dead ends.

Maintenance

ActivityInactive
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/cqtrinv/trinvmcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server