docs(admin): add MCP server OpenAPI reference

[kayx23]

Summary

• document the existing MCP server Admin API routes in the generated OpenAPI source
• include the generated MCP server resource schema in the Admin API reference
• add ReDoc titles for MCP enum variants so rendered reference tabs are readable

Runtime impact

This PR does not change runtime behavior. The MCP admin routes and handlers are already mounted in the admin router on main; this change only updates OpenAPI/reference metadata and the generated resource schema titles used by documentation.

Validation

• cargo run -p aisix-core --bin dump-schema
• cargo test -p aisix-admin openapi_
• cargo run -p aisix-admin --bin dump-openapi > /tmp/aisix-admin-openapi-mcp.json
• cargo fmt --check

[coderabbitai]

📝 Walkthrough

Walkthrough

Adds OpenAPI documentation for /admin/v1/mcp_servers and /admin/v1/mcp_servers/{id} endpoints including McpServerEntry schema, MCP Servers tag, and McpServer resource schema registration. Also injects title metadata into McpAuthType and McpTransport enum variant definitions via a new post-processing helper.

MCP Server OpenAPI Documentation and Schema Titles

Layer / File(s)	Summary
Enum variant title injection crates/aisix-core/src/models/schema.rs, schemas/resources/mcp_server.schema.json	mcp_server_root_schema() calls new title_single_value_enum_variants() to insert title fields into McpAuthType (none, bearer) and McpTransport (streamable_http) oneOf branches; the compiled schema JSON reflects these additions.
MCP server OpenAPI paths, schemas, and tags crates/aisix-admin/src/openapi.rs	Adds GET/POST /admin/v1/mcp_servers and GET/PUT/DELETE /admin/v1/mcp_servers/{id} path entries, McpServerEntry component schema, MCP Servers tag, and registers mcp_server.schema.json in RESOURCE_SCHEMAS.
Test updates crates/aisix-admin/src/openapi.rs	Three existing tests updated to assert MCP server paths and schemas exist and that body-size rejection is documented for POST/PUT /admin/v1/mcp_servers*.

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related issues

• Document /admin/v1/mcp_servers in the Admin API OpenAPI #663: This PR directly implements the /admin/v1/mcp_servers OpenAPI documentation and schema/test updates described in that issue.

Possibly related PRs

• api7/aisix#664: Introduces the MCP server admin CRUD resource and mcp_server schema that this PR's OpenAPI and title annotation changes build upon.

🚥 Pre-merge checks | ✅ 6

✅ Passed checks (6 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly matches the main change: adding MCP server OpenAPI documentation for the admin API.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
E2e Test Quality Review	✅ Passed	PASS: The new OpenAPI/schema tests are readable and targeted; real E2E MCP CRUD coverage already exists in crates/aisix-admin/tests/etcd_integration.rs against real etcd.
Security Check	✅ Passed	PASS: Docs/schema-only changes; no runtime logging, auth, storage, TLS, or ownership logic changed, and no secret exposure or bypass issues found.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/mcp-admin-openapi-reference

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}