mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-14 23:21:08 +02:00
db4dd437bd
Mount an MCP (Model Context Protocol) server at /api/v1/mcp in the
unified Hono API. External clients like Claude Desktop, Cursor, and
VS Code Copilot can discover and call all 29 Mana tools via the
standard MCP protocol.
Architecture:
- WebStandardStreamableHTTPServerTransport for Bun/Hono compatibility
- AI_TOOL_CATALOG → MCP tool definitions with JSON Schema (via Zod)
- Stateful sessions with Mcp-Session-Id header
- Auth via existing authMiddleware (JWT or API key)
Phase 1 scope: tools/list returns all 29 tools with schemas,
tools/call acknowledges with descriptive messages. Phase 2 will add
actual DB reads/writes via sync_changes.
Usage:
Claude Desktop config:
{"mcpServers": {"mana": {"url": "http://localhost:3060/api/v1/mcp"}}}
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
81 lines
3.5 KiB
TypeScript
81 lines
3.5 KiB
TypeScript
/**
|
|
* Mana Unified API Server
|
|
*
|
|
* Consolidates all app compute servers into one Hono/Bun process.
|
|
* Each module registers its routes under /api/v1/{module}/*.
|
|
*/
|
|
|
|
import { Hono } from 'hono';
|
|
import { cors } from 'hono/cors';
|
|
import {
|
|
authMiddleware,
|
|
healthRoute,
|
|
errorHandler,
|
|
notFoundHandler,
|
|
rateLimitMiddleware,
|
|
} from '@mana/shared-hono';
|
|
|
|
// MCP server
|
|
import { handleMcpRequest } from './mcp/server';
|
|
|
|
// Module routes
|
|
import { calendarRoutes } from './modules/calendar/routes';
|
|
import { contactsRoutes } from './modules/contacts/routes';
|
|
import { musicRoutes } from './modules/music/routes';
|
|
import { chatRoutes } from './modules/chat/routes';
|
|
import { contextRoutes } from './modules/context/routes';
|
|
import { pictureRoutes } from './modules/picture/routes';
|
|
import { storageRoutes } from './modules/storage/routes';
|
|
import { todoRoutes } from './modules/todo/routes';
|
|
import { plantsRoutes } from './modules/plants/routes';
|
|
import { foodRoutes } from './modules/food/routes';
|
|
import { guidesRoutes } from './modules/guides/routes';
|
|
import { moodlitRoutes } from './modules/moodlit/routes';
|
|
import { newsRoutes } from './modules/news/routes';
|
|
import { newsResearchRoutes } from './modules/news-research/routes';
|
|
import { tracesRoutes } from './modules/traces/routes';
|
|
import { presiRoutes } from './modules/presi/routes';
|
|
import { researchRoutes } from './modules/research/routes';
|
|
import { whoRoutes } from './modules/who/routes';
|
|
|
|
const PORT = parseInt(process.env.PORT || '3060', 10);
|
|
const CORS_ORIGINS = (process.env.CORS_ORIGINS || 'http://localhost:5173').split(',');
|
|
|
|
const app = new Hono();
|
|
|
|
// ─── Global Middleware ──────────────────────────────────────
|
|
app.onError(errorHandler);
|
|
app.notFound(notFoundHandler);
|
|
app.use('*', cors({ origin: CORS_ORIGINS, credentials: true }));
|
|
app.route('/health', healthRoute('mana-api'));
|
|
app.use('/api/*', rateLimitMiddleware({ max: 200, windowMs: 60_000 }));
|
|
app.use('/api/*', authMiddleware());
|
|
|
|
// ─── MCP Endpoint ──────────────────────────────────────────
|
|
// Streamable HTTP transport: POST (messages), GET (SSE stream), DELETE (close)
|
|
app.all('/api/v1/mcp', (c) => handleMcpRequest(c.req.raw));
|
|
|
|
// ─── Module Routes ──────────────────────────────────────────
|
|
app.route('/api/v1/calendar', calendarRoutes);
|
|
app.route('/api/v1/contacts', contactsRoutes);
|
|
app.route('/api/v1/music', musicRoutes);
|
|
app.route('/api/v1/chat', chatRoutes);
|
|
app.route('/api/v1/context', contextRoutes);
|
|
app.route('/api/v1/picture', pictureRoutes);
|
|
app.route('/api/v1/storage', storageRoutes);
|
|
app.route('/api/v1/todo', todoRoutes);
|
|
app.route('/api/v1/plants', plantsRoutes);
|
|
app.route('/api/v1/food', foodRoutes);
|
|
app.route('/api/v1/guides', guidesRoutes);
|
|
app.route('/api/v1/moodlit', moodlitRoutes);
|
|
app.route('/api/v1/news', newsRoutes);
|
|
app.route('/api/v1/news-research', newsResearchRoutes);
|
|
app.route('/api/v1/traces', tracesRoutes);
|
|
app.route('/api/v1/presi', presiRoutes);
|
|
app.route('/api/v1/research', researchRoutes);
|
|
app.route('/api/v1/who', whoRoutes);
|
|
|
|
// ─── Server Info ────────────────────────────────────────────
|
|
console.log(`mana-api starting on port ${PORT}...`);
|
|
|
|
export default { port: PORT, fetch: app.fetch };
|