Feature/mcp tools selection improvement

[mikewoo]

Change Type

• Bug fix (fix)
• New feature (feat)
• Documentation (docs)
• Chore (chore)
• Refactoring (refactor)

Description

MCP Tools Selection in Agent Edit Dialog

Replaced the flat tool checklist in the Agent edit dialog with a new MCP Tools tab that groups tools by server with rich context:

• New API: GET /api/v1/mcp-servers/tools — batch-returns all servers with their tools, including online status, inputSchema, and server metadata
• Server context: Each server header shows name, online/offline badge, tool count, and optional description
• Tool details: Expandable parameter schema preview for each tool (required/optional params, types, descriptions)
• Offline awareness: Tools belonging to offline servers are disabled with a visual indicator
• Mockup alignment: Param format display, button labels, and visual separators match the approved design mockup

MCP Server description Field

Added an optional description field to MCP Server across the entire stack:

Layer	Changes
Database	Flyway V7 idempotent migration + deploy/sql/init_eify_mysql.sql
Backend	Entity, Create/Update/Response DTOs, Service, Controller
Frontend API	McpServerCreateRequest, McpServerUpdateRequest, McpServerResponse, McpServerToolsResponse
Frontend UI	Add/edit form (textarea, 500 char limit), table, card, and detail views
i18n	en-US.json + zh-CN.json placeholder text

Bug Fixes

• MCP Tools tab text invisible: Element Plus .el-checkbox-group { font-size: 0; line-height: 0 } cascaded into custom elements inside the group, zeroing out all text rendering. Fixed by explicitly declaring font-size and line-height on .tool-group, .tool-group-header, .tool-item,
  .tool-desc, .tool-params, and .param-row.
• Form label asterisk separated from text: el-form-item__label defaults to display: inline-flex; justify-content: flex-end, which treats the ::before asterisk and the label text as independent flex items — causing them to spread apart like space-between. Fixed by overriding to display: block; text-align: right, keeping the asterisk and text as a single inline flow.

Version Bump

• Backend pom.xml: 1.0.1-SNAPSHOT → 1.0.2-SNAPSHOT
• Frontend package.json + package-lock.json: 1.0.1-SNAPSHOT → 1.0.2-SNAPSHOT

Testing

• mvn test passes locally
• npx vue-tsc --noEmit type check passes
• npx vitest run passes
• Core functionality manually verified (add/edit MCP Server with description, Agent MCP Tools tab with server grouping, online/offline state, param preview expand/collapse)
• New features have test coverage (McpServerServiceTest.listToolsByWorkspace, controller integration tests for /tools endpoint)

Checklist

• Database indexes: description is a display-only column not used in WHERE / JOIN clauses — no index needed. Flyway migration uses INFORMATION_SCHEMA check for idempotency.
• Workspace isolation: /api/v1/mcp-servers/tools delegates to listToolsByWorkspace, which filters by WorkspaceContext.getWorkspaceId(). All existing CRUD operations already enforce workspace scoping.
• Error handling: All new code paths use ErrorCode enum via BusinessException. No RuntimeException or raw-string errors.
• Log format: No logging changes. Existing JSON/UTC logging unchanged.
• Config security: No new configuration keys, no hardcoded passwords or API keys.
• XSS protection: No new v-html usage. All dynamic content rendered via Vue template bindings.

Related Issue

N/A

Screenshots