HAPI MCP Server

السجل الرسمي أدوات المطورين

HAPI MCP server: Dynamically exposes OpenAPI REST APIs as MCP tools for AI assistants

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code
claude mcp add --transport http hapi-mcp-server 'https://{HAPI_FQDN}:{HAPI_PORT}/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "hapi-mcp-server": {
            "type": "http",
            "url": "https://{HAPI_FQDN}:{HAPI_PORT}/mcp"
        }
    }
}
OCI package docker.io/hapimcp/hapi-cli:0.6.0
Claude Code
claude mcp add hapi-mcp-server -e 'HAPI_FQDN=localhost' -e 'HAPI_HOME=/app/.hapi' -e 'PROJECT_NAME=<PROJECT_NAME>' -e 'HAPI_OPENAPI=<HAPI_OPENAPI>' -e 'HAPI_URL=<HAPI_URL>' -e 'HAPI_PORT=3030' -e 'HAPI_HEADLESS=true' -e 'HAPI_MCP=true' -e 'HAPI_DEV=<HAPI_DEV>' -e 'HAPI_CORS=<HAPI_CORS>' -e 'HAPI_CONFIG_FILES=<HAPI_CONFIG_FILES>' -e 'NODE_ENV=production' -- docker run -i --rm docker.io/hapimcp/hapi-cli:0.6.0 '<serve>' '<petstore>' --port '<port>' --headless --mcp --dev --url '<url>' --openapi '<openapi>' --cors '<origins>' --filename '<files>' --cert '<path>' --key '<path>'
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "hapi-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/hapimcp/hapi-cli:0.6.0",
                "<serve>",
                "<petstore>",
                "--port",
                "<port>",
                "--headless",
                "--mcp",
                "--dev",
                "--url",
                "<url>",
                "--openapi",
                "<openapi>",
                "--cors",
                "<origins>",
                "--filename",
                "<files>",
                "--cert",
                "<path>",
                "--key",
                "<path>"
            ],
            "env": {
                "HAPI_FQDN": "localhost",
                "HAPI_HOME": "/app/.hapi",
                "PROJECT_NAME": "<PROJECT_NAME>",
                "HAPI_OPENAPI": "<HAPI_OPENAPI>",
                "HAPI_URL": "<HAPI_URL>",
                "HAPI_PORT": "3030",
                "HAPI_HEADLESS": "true",
                "HAPI_MCP": "true",
                "HAPI_DEV": "<HAPI_DEV>",
                "HAPI_CORS": "<HAPI_CORS>",
                "HAPI_CONFIG_FILES": "<HAPI_CONFIG_FILES>",
                "NODE_ENV": "production"
            }
        }
    }
}

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

  • HAPI_FQDN Fully Qualified Domain Name for the HAPI server (used in MCP tool URLs)
  • HAPI_HOME Directory path for HAPI configuration and specs. Should be mounted as a volume in Docker
  • PROJECT_NAME The name of the project/API (alternative to positional argument)
  • HAPI_OPENAPI OpenAPI spec URL or path (alternative to --openapi flag)
  • HAPI_URL Backend API base URL (alternative to --url flag)
  • HAPI_PORT Server port (alternative to --port flag) - this is the internal container port
  • HAPI_HEADLESS Enable headless mode (alternative to --headless flag)
  • HAPI_MCP Enable MCP mode (alternative to --mcp flag)
  • HAPI_DEV Enable development mode (alternative to --dev flag)
  • HAPI_CORS Comma-separated allowed CORS origins (alternative to --cors flag)
  • HAPI_CONFIG_FILES Comma-separated configuration files (alternative to --filename flag)
  • NODE_ENV Node environment (development, production). 'development' enables verbose logging and debugging features.

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

ما هو HAPI MCP Server؟

HAPI MCP server: Dynamically exposes OpenAPI REST APIs as MCP tools for AI assistants

كيف أثبّت HAPI MCP Server؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http hapi-mcp-server 'https://{HAPI_FQDN}:{HAPI_PORT}/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج HAPI MCP Server إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل HAPI MCP Server مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون HAPI MCP Server؟

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

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