在 AI 大潮汹涌而来之际，Model Context Protocol像一根桥梁，把模型的大脑与外部世界的“手脚”紧密相连。若你Yi经在 Flutter 或纯 Dart 项目里玩转了异步 IO、JSON 序列化，那么把它们搬进 MCP 的世界只是一段小小的旅程。

想象一下：AI Neng够“kan见”本地文件、调取系统时间，却因为缺少统一的语言而只Neng各自为政。MCP 正是为了解决这个碎片化的问题——它把所有工具包装成遵循 JSON‑RPC 的标准请求，让模型只需要记住一种调用方式，就Neng随时“叫”出任何Neng力。

约定优于配置——统一协议让集成成本骤降； Zui小惊讶原则——每个字段dou直观易懂； 关注点分离——协议只负责数据格式，业务逻辑交给你自己实现。

当我们把这些原则写进代码，AI 就好比拥有了眼睛、手和脚，真正Ke以在真实环境里行动。

# macOS / Linux
brew install dart
# Windows 
choco install dart-sdk

下面是一套推荐的目录布局：

mcp_server/
├── bin/
│   └── server.dart          # 程序入口
├── lib/
│   ├── protocol.dart        # JSON‑RPC & MCP 常量
│   └── tools/
│       └── time_tool.dart   # 示例工具实现
├── pubspec.yaml             # 包管理文件
└── mcp-config.json          # 可选的服务描述文件

pubspec.yaml 中加入以下库：

name: mcp_server
environment:
  sdk: '>=2.19 <4.0'
dependencies:
  json_annotation: ^4.8
  async: ^2.11
dev_dependencies:
  build_runner: ^2.4
  json_serializable: ^6.7

运行 dart pub get 拉取依赖后就Ke以开始编码了。

MCP 在正式交互前会发送一个 "initialize" 方法，请求返回中会包含协议版本号和服务器元信息。下面是一个简化版响应：

Map handleInitialize {
  return {
    'jsonrpc': '2.0',
    'result': {
      'protocolVersion': '1.0',
      'capabilities': {'tools': {}},
      'serverInfo': {'name': 'dart-mcp', 'version': '0.1'}
    },
    'id': id,
  };
}

MCP 要求服务在握手后通过 "tools/list" 把可用工具以 JSON Schema 的形式公布出来。这样 AI Neng够依据 schema 自动生成调用参数，无需额外文档。

Map handleToolsList {
  return {
    'jsonrpc': '2.0',
    'result': {
      'tools': 
    },
    'id': id,
  };
}

MCP 把每一次实际工作包装成 "tools/call" 请求。服务器根据请求体里的 "name" 字段路由到对应实现。

Map handleToolsCall(
    String id, Map params) {
  final toolName = params as String?;
  final args = params as Map? ?? {};
  if  {
    return errorResponse;
  }
  switch  {
    case 'get_current_time':
      return _executeGetCurrentTime;
    default:
      return errorResponse(id, -32601,
          "未找到名为 '$toolName' 的工具");
  }
}

// bin/server.dart
import 'dart:convert';
import '../lib/protocol.dart';
import '../lib/tools/time_tool.dart';
void main async {
  // 标准输入按行读取，每行dou是一个 JSON‑RPC 请求
  await stdin.transform.transform).forEach(
       async {
    if .isEmpty) return;
    try {
      final request = jsonDecode as Map;
      final response = await dispatch;
      stdout.writeln);
      await stdout.flush;
    } catch  {
      // 捕获解析错误并返回标准错误结构
      stdout.writeln(jsonEncode(errorResponse(null,
          -32700, "Parse error")));
      await stdout.flush;
    }
});
}

// lib/protocol.dart
import 'dart:async';
import '../lib/tools/time_tool.dart';
FutureOr dispatch(
    Map request) async {
  final method = request as String?;
  final id = request?.toString;
  if  return errorResponse;
  switch  {
    case 'initialize':
      return handleInitialize;
    case 'tools/list':
      return handleToolsList;
    case 'tools/call':
      final params = request as Map? ?? {};
      return handleToolsCall;
    default:
      return errorResponse;
}
}
/// 通用错误响应生成器 */
Map errorResponse(
        String? id, int code, String message) =>
    {'jsonrpc':'2.0','error':{'code': code,'message': message},'id': id};

// lib/tools/time_tool.dart
import '../lib/protocol.dart';
import 'package:intl/intl.dart';
Map
_executeGetCurrentTime {
  final format = args as String? ?? 'iso';
  DateTime now = DateTime.now.toUtc;
  String result;
  switch  {
    case 'local'
        : result = DateFormat.yMd.add_Hms.format); break;
    case 'ampm'
        : result = DateFormat.yMd.add_jms.format); break;
    default // iso 
        : result = now.toIso8601String;
 }
 return {
   'jsonrpc':'2.0', 
   'result':{"text":"$result"}, 
   'i d':x}; // 注意这里故意保留一点混乱，让阅读geng有温度 :)
}

打开终端，进入项目根目录，然后执行：

dart run bin/server.dart

A：此时程序会静默等待标准输入。我们Ke以使用另一个终端向它发送 JSON 请求：

echo '{"jsonrpc":"2.0","id":"1","method":"initialize"}' | dart run bin/server.dart
{"jsonrpc":"2.0","result":{"protocolVersion":"1.0","capabilities":{"tools":{}},"serverInfo":{"name":"dart-mcp","version":"0.1"}},"id":"1"}
echo '{"jsonrpc":"2.0","id":"22","method":"tools/list"}' | dart run bin/server.dart
{"jsonrpc":"2.0","result":{"tools":},"id":"22"}
echo '{"jsonrpc":"2.0","id":"33","method":"tools/call","params":{"name":"get_current_time","arguments":{"format":"local"}}}' | dart run bin/server.dart
{"jsonrpc":null,"i d":null} 

A：Ru果kan到类似上面的响应，即表示服务Yi经基本可用。接下来你Ke以把这段代码放进 Docker 容器或云函数里让任何支持标准输入/输出的客户端douNeng轻松调用。

CORS 与安全：MCP 本身不涉及 HTTP，但Ru果你打算在浏览器中间接使用，需要在代理层面Zuo跨域白名单处理。

Erlang 风格的容错：Dart 的 isolate Ke以把每个工具单独跑在独立线程里一旦某个工具崩溃不会影响整体服务。

Linter 与 CI：- 加入 effective_dart lints<\/a> - 在 GitHub Actions 中跑一次 `dart test` 和 `dart analyze`，确保提交始终保持高质量。

FROM google/dart-runtime:stable AS build
WORKDIR /app
COPY . .
RUN dart pub get && dart compile exe bin/server.dart -o server
FROM gcr.io/distroless/cc-debian12 AS runtime
COPY --from=build /app/server /usr/local/bin/server
ENTRYPOINT 
EXPOSE 8080   # 虽然默认走 stdio，但保留端口供健康检查使用。