MCP 服务器

Finch 可以作为 Model Context Protocol (MCP) 服务器，允许 Claude、Copilot 等 AI 工具与你的应用程序交互。

设置

1. 创建 McpServerController

import 'package:finch/mcp.dart';

class AppMcpController extends McpServerController {
  @override
  McpBuilder build(McpBuilder mcp) {
    return mcp
      .tool(
        name: 'get_user',
        description: '通过 ID 获取用户信息',
        inputSchema: {
          'type': 'object',
          'properties': {
            'id': {'type': 'integer', 'description': '用户 ID'},
          },
          'required': ['id'],
        },
        handler: (params) async {
          var id = params['id'] as int;
          var user = await UserModel().findById(id);
          return {'user': user?.toJson()};
        },
      )
      .resource(
        uri: 'app://config',
        name: '应用配置',
        description: '当前应用配置',
        handler: () async => {
          'version': '1.0.0',
          'env': FinchApp.config.env,
        },
      );
  }
}

2. 注册路由

router.mcp('/mcp', AppMcpController());

McpBuilder 方法

内置 JSON-RPC 方法

认证

使用 AuthMiddleware 保护 MCP 端点：

router
    .mcp('/mcp', AppMcpController())
    .middleware(ApiKeyMiddleware());

class ApiKeyMiddleware extends Middleware {
  @override
  Future<MiddlewareResult> handle(FinchRequest rq) async {
    var key = rq.headers['x-api-key']?.first ?? '';
    if (key != FinchApp.config.env['MCP_API_KEY']) {
      return MiddlewareResult.stop(
        rq.renderData(data: {'error': 'Unauthorized'}, statusCode: 401),
      );
    }
    return MiddlewareResult.next();
  }
}