English Français العربية

io.github.agntcy/dir-mcp

السجل الرسمي الذكاء الاصطناعي والوكلاء

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

  • OASF_API_VALIDATION_SCHEMA_URL إلزامي 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 سري 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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على 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.

الأسئلة الشائعة

ما هو io.github.agntcy/dir-mcp؟

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

كيف أثبّت io.github.agntcy/dir-mcp؟

يعمل على جهازك. في 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.agntcy/dir-mcp إلى مفتاح API؟

نعم. يتطلب OASF_API_VALIDATION_SCHEMA_URL, DIRECTORY_CLIENT_AUTH_TOKEN، وتضبطها في إعداداته.

هل io.github.agntcy/dir-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.

من يصون io.github.agntcy/dir-mcp؟

ينشره agntcy. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.