Add Model Context Protocol (MCP) Server using Node.js and TypeScript

[jumperck]

Description

Add a Model Context Protocol (MCP) server implementation to the Reminders project using Node.js and TypeScript. This will enable AI assistants to interact with the Reminders application through a standardized protocol.

Goals

• Implement an MCP server that exposes Reminders API functionality
• Use Node.js runtime with TypeScript for type safety
• Follow MCP specification for server implementation
• Integrate with existing API endpoints (load-balanced .NET and Go APIs)

Technical Considerations

• Location: Create new directory at src/server/services/nodejs/reminders-mcp-server/
• Technology Stack:
  • Node.js runtime
  • TypeScript for type-safe development
  • MCP SDK (@modelcontextprotocol packages)
• Integration: Connect to existing APIs via Nginx load balancer (http://reminders-nginx:9999)
• Docker: Add service to docker-compose.yml with appropriate profile

Proposed Features

The MCP server should expose tools for:

• Creating reminders
• Retrieving reminders (single and list)
• Updating reminders
• Deleting reminders
• Optionally: blockchain integration queries

Acceptance Criteria

• MCP server successfully connects and responds to MCP protocol messages
• All CRUD operations for reminders are exposed as MCP tools
• TypeScript types properly defined for all operations
• Docker Compose integration with appropriate profile
• Documentation for connecting AI clients to the MCP server
• Basic error handling and logging implemented

References

• MCP Specification
• Existing API: src/server/api/dotnet/Reminders.Api/
• Current architecture documentation in README.md

Related Work

This builds on the existing multi-language API approach (already have .NET and Go implementations) by adding MCP protocol support for AI assistant integration.