Skip to content

feat: implement migration plan from low-level Server API to high-level McpServer API#386

Merged
jirispilka merged 3 commits intomasterfrom
feat/mcp-server-high-level-api
Jan 15, 2026
Merged

feat: implement migration plan from low-level Server API to high-level McpServer API#386
jirispilka merged 3 commits intomasterfrom
feat/mcp-server-high-level-api

Conversation

@jirispilka
Copy link
Collaborator

@jirispilka jirispilka commented Jan 8, 2026

What:
Refactor src/mcp/server.ts from the deprecated low-level Server API to the recommended high-level McpServer API.

Why:

  • The low-level API is deprecated by the MCP SDK maintainers
  • The high-level API provides automatic tool management and notifications
  • Opportunity to simplify architecture and reduce code by ~500 lines

Impact:

  • All existing features preserved (dynamic tool loading, Actor-MCP proxy, notifications)
  • Cleaner, more maintainable codebase
  • Future-proof against SDK changes

IMPORTANT - We don't want to start with implementation. This is only an analysis and possible impact

@jirispilka jirispilka marked this pull request as ready for review January 8, 2026 13:38
@github-actions github-actions bot added the t-ai Issues owned by the AI team. label Jan 8, 2026
@jirispilka jirispilka requested a review from MQ37 January 8, 2026 13:41
Copy link
Contributor

@MQ37 MQ37 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the plans looks good but we will encounter a lot of issues when actually implementing this. I think we should make our testing setup more robust before doing changes like this and that would be with the refactor at least one full sprint effort I think. It may be worth it as it sometimes happen that the SDK update introduces breaking changes for our implementation.

### Key Changes

1. **Replace `Server` with `McpServer`** - Use high-level API as foundation
2. **Convert JSON Schema to Zod** - Use `json-schema-to-zod` library for Actor schemas
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

json-schema-to-zod is deprecated with Zod v4 as v4 supports this natively

@jirispilka jirispilka merged commit d9cc6bf into master Jan 15, 2026
4 checks passed
@jirispilka jirispilka deleted the feat/mcp-server-high-level-api branch January 15, 2026 12:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

t-ai Issues owned by the AI team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants