English Français العربية

io.github.agntcy/dir-mcp

Registre officiel IA et agents

MCP server for working with OASF agent records in the Agntcy Directory.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

OCI package ghcr.io/agntcy/dir-mcp:1.3.4
Claude Code 
claude mcp add dir-mcp -e 'OASF_API_VALIDATION_SCHEMA_URL=<OASF_API_VALIDATION_SCHEMA_URL>' -e 'DIRECTORY_CLIENT_SERVER_ADDRESS=<DIRECTORY_CLIENT_SERVER_ADDRESS>' -e 'DIRECTORY_CLIENT_AUTH_MODE=<DIRECTORY_CLIENT_AUTH_MODE>' -e 'DIRECTORY_CLIENT_AUTH_TOKEN=<your directory_client_auth_token>' -- docker run -i --rm ghcr.io/agntcy/dir-mcp:1.3.4
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "dir-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/agntcy/dir-mcp:1.3.4"
            ],
            "env": {
                "OASF_API_VALIDATION_SCHEMA_URL": "<OASF_API_VALIDATION_SCHEMA_URL>",
                "DIRECTORY_CLIENT_SERVER_ADDRESS": "<DIRECTORY_CLIENT_SERVER_ADDRESS>",
                "DIRECTORY_CLIENT_AUTH_MODE": "<DIRECTORY_CLIENT_AUTH_MODE>",
                "DIRECTORY_CLIENT_AUTH_TOKEN": "<your directory_client_auth_token>"
            }
        }
    }
}

Variables d'environnement

  • OASF_API_VALIDATION_SCHEMA_URL obligatoire OASF schema server URL (e.g. https://schema.oasf.outshift.com)
  • DIRECTORY_CLIENT_SERVER_ADDRESS Directory server address (default: 0.0.0.0:8888)
  • DIRECTORY_CLIENT_AUTH_MODE Auth mode: none, github, x509, jwt, token
  • DIRECTORY_CLIENT_AUTH_TOKEN secret Pre-issued bearer token for CI/scripts (skips interactive login)
MCPB package https://github.com/agntcy/dir-mcp/releases/download/v1.3.4/dir-mcp.mcpb

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

MCP Server for Directory

Model Context Protocol (MCP) server for working with OASF agent records in the AGNTCY Agent Directory.

The server runs via the dirctl CLI and connects AI assistants and IDEs to Directory infrastructure. Use it to validate and publish agent metadata, search and discover records, navigate OASF skill and domain taxonomies, and generate records from a codebase.

Capabilities:

  • Work with OASF schemas and validate agent records
  • Search, push, and pull records from Directory servers
  • Verify record signatures and domain name ownership
  • Import from and export to MCP, A2A, Agent Skills, and GitHub Copilot formats
  • Start an embedded local Directory daemon automatically when the configured server is local (disable with DIR_MCP_DAEMON=false)
  • Run guided workflows via MCP prompts (create, validate, search, and more)

See docs/directory-mcp.md for full documentation — tools, prompts, setup, configuration, and usage.

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated. For detailed contributing guidelines, please see CONTRIBUTING.md.

License

Distributed under the Apache-2.0 License. See LICENSE.md for more information.

Questions fréquentes

Qu'est-ce que io.github.agntcy/dir-mcp ?

MCP server for working with OASF agent records in the Agntcy Directory.

Comment installer io.github.agntcy/dir-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add dir-mcp -e 'OASF_API_VALIDATION_SCHEMA_URL=<OASF_API_VALIDATION_SCHEMA_URL>' -e 'DIRECTORY_CLIENT_SERVER_ADDRESS=<DIRECTORY_CLIENT_SERVER_ADDRESS>' -e 'DIRECTORY_CLIENT_AUTH_MODE=<DIRECTORY_CLIENT_AUTH_MODE>' -e 'DIRECTORY_CLIENT_AUTH_TOKEN=<your directory_client_auth_token>' -- docker run -i --rm ghcr.io/agntcy/dir-mcp:1.3.4. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.agntcy/dir-mcp ?

Oui. Il attend OASF_API_VALIDATION_SCHEMA_URL, DIRECTORY_CLIENT_AUTH_TOKEN, à renseigner dans sa configuration.

io.github.agntcy/dir-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence Apache-2.0.

Qui maintient io.github.agntcy/dir-mcp ?

Il est publié par agntcy. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.