mm_ai 1.0.0

package/core/mcp/index.js

@@ -0,0 +1,369 @@
+const { Http } = require('mm_https');
+const { Mod } = require('mm_machine');
+
+/**
+ * MCP智能体
+ */
+class MCP extends Mod {
+  /**
+   * 配置项
+   */
+  static config = {
+    name: '',
+    version: '1.0',
+    url: 'http://localhost:8000',
+    timeout: 10000,
+    headers: {
+      'Content-Type': 'application/json'
+    },
+    // 请求方法
+    method: 'POST',
+    // API密钥
+    apikey: '',
+    // 请求结构
+    request: {
+      jsonrpc: '2.0',
+      id: 'id',
+      method: 'method',
+      params: 'params'
+    },
+    // 响应结构
+    response: {
+      jsonrpc: '2.0',
+      id: 'id',
+      method: 'method',
+      result: 'result',
+      error: 'error'
+    },
+    // 错误结构
+    error: {
+      code: 'code',
+      message: 'message',
+      data: 'data'
+    },
+    // 主程序 - 无
+    main: ''
+  };
+
+  /**
+   * 构造函数
+   * @param {object} config - 配置项对象
+   * @param {object} parent 父对象
+   */
+  constructor(config, parent) {
+    super({ ...MCP.config, ...config }, parent);
+  }
+}
+
+/**
+ * 初始化MCP核心
+ * @param {object} server - 服务器实例
+ * @param {object} eventer - 事件触发器
+ * @param {object} logger - 日志记录器
+ */
+MCP.prototype._initCore = function (server, eventer, logger) {
+  if (logger) {
+    this.getLogger = function () {
+      return logger;
+    };
+  }
+  if (eventer) {
+    this.getEventer = function () {
+      return eventer;
+    };
+  }
+  if (server) {
+    this.getServer = function () {
+      return server;
+    };
+  }
+};
+
+/**
+ * 准备MCP连接
+ */
+MCP.prototype._preset = async function () {
+  if (!this._http) {
+    this._http = new Http(this.config);
+  }
+};
+
+/**
+ * 转换MCP请求为JSON-RPC格式
+ * @param {object} body - 请求体对象
+ * @returns {object} - JSON-RPC请求对象
+ */
+MCP.prototype.convertIn = function (body) {
+  let msg = {};
+  let request = this.config.request;
+  for (let key in request) {
+    msg[key] = body[request[key]];
+  }
+  return msg;
+};
+
+/**
+ * 转换JSON-RPC响应为MCP格式
+ * @param {object} body - 响应体对象
+ * @returns {object} - MCP响应对象
+ */
+MCP.prototype.convertOut = function (body) {
+  let msg = {};
+  let response = this.config.response;
+  for (let key in response) {
+    msg[key] = body[response[key]];
+  }
+  return msg;
+};
+
+/**
+ * 发送MCP请求
+ * @param {string} method - 请求方法
+ * @param {object} params - 请求参数对象
+ * @returns {object} - 响应对象
+ */
+MCP.prototype._send = async function (method, params) {
+  let res = await this._request('/mcp', 'POST', {}, this.convertIn({
+    method,
+    params
+  }));
+  if (res.body) {
+    let json = JSON.parse(res.body);
+    return this.convertOut(json);
+  }
+};
+
+/**
+ * 构建请求
+ * @param {string} path - 请求路径
+ * @param {string} method - 请求方法
+ * @param {object} query - 查询参数对象
+ * @param {object} body - 请求体对象
+ * @returns {object} - 请求对象
+ */
+MCP.prototype._request = async function (path, method, query, body) {
+  let url = this.config.url + path;
+  if (query) {
+    url += '?' + new URLSearchParams(query).toString();
+  }
+  return await this._http[method](url, body, this.config.headers);
+};
+
+/**
+ * 初始化MCP，握手方法，用于协商协议版本和能力。必须在任何其他请求之前调用。
+ * @returns {object} - 响应对象
+ */
+MCP.prototype.initialize = async function () {
+  if (!this._http) {
+    this._http = new Http(this.config);
+  }
+
+  let msg = await this._send('initialize', {
+    'protocolVersion': '2025-01-01',
+    'capabilities': { 'roots': { 'listChanged': true } },
+    'clientInfo': { 'name': this.config.name, 'version': this.config.version }
+  });
+  if (msg.result) {
+    this.can_req = true;
+    this._server = msg.result.server;
+  }
+  return msg;
+};
+
+/**
+ * 发送Ping请求，检查服务端是否响应。
+ * @returns {object} - 响应对象
+ */
+MCP.prototype.ping = async function () {
+  if (!this.can_req) {
+    return { error: { code: 400, message: 'MCP 未初始化' } };
+  }
+  return await this._send('ping', {});
+};
+
+/**
+ * 获取工具列表，列出服务端提供的所有可用工具及其元信息（如名称、描述、输入参数Schema）。
+ * @param {object} query - 查询参数对象
+ * @returns {object} - 响应对象
+ */
+MCP.prototype.getToolList = async function (query) {
+  if (!this.can_req) {
+    return { error: { code: 400, message: 'MCP 未初始化' } };
+  }
+  return await this._send('tools/list', query);
+};
+
+/**
+ * 发送工具调用请求，调用服务端提供的工具函数。
+ * @param {string} name - 工具名称
+ * @param {object} args - 工具参数对象
+ * @returns {object} - 响应对象
+ */
+MCP.prototype.callTool = async function (name, args) {
+  if (!this.can_req) {
+    return { error: { code: 400, message: 'MCP 未初始化' } };
+  }
+  return await this._send('tools/call', {
+    name,
+    arguments: args
+  });
+};
+
+/**
+ * 获取提示词列表，列出服务端可提供的提示词模板（如系统提示、用户提示等）。
+ * @param {object} query - 查询参数对象
+ * @returns {object} - 响应对象
+ */
+MCP.prototype.getPromptList = async function (query) {
+  if (!this.can_req) {
+    return { error: { code: 400, message: 'MCP 未初始化' } };
+  }
+  return await this._send('prompts/list', query);
+};
+
+/**
+ * 获取提示词详情，根据提示词ID获取详细信息（如模板内容、参数说明等）。
+ * @param {string} name - 提示词名称
+ * @returns {object} - 响应对象
+ */
+MCP.prototype.getPrompt = async function (name) {
+  if (!this.can_req) {
+    return { error: { code: 400, message: 'MCP 未初始化' } };
+  }
+  return await this._send('prompts/get', {
+    name
+  });
+};
+
+/**
+ * 获取列表，列出服务端可提供的数据资源（如数据库表、文件路径等）。
+ * @param {object} query - 查询参数对象
+ * @returns {object} - 响应对象
+ */
+MCP.prototype.getResourceList = async function (query) {
+  if (!this.can_req) {
+    return { error: { code: 400, message: 'MCP 未初始化' } };
+  }
+  return await this._send('resources/list', query);
+};
+
+/**
+ * 读取服务端提供的数据资源（如数据库表、文件路径等）。
+ * @param {string} uri - 资源URI
+ * @returns {object} - 响应对象
+ */
+MCP.prototype.readResource = async function (uri) {
+  if (!this.can_req) {
+    return { error: { code: 400, message: 'MCP 未初始化' } };
+  }
+  return await this._send('resources/read', {
+    uri
+  });
+};
+
+/**
+ * 订阅服务端提供的数据资源（如数据库表、文件路径等）。
+ * @param {string} uri - 资源URI
+ * @returns {object} - 响应对象
+ */
+MCP.prototype.subscribeResource = async function (uri) {
+  if (!this.can_req) {
+    return { error: { code: 400, message: 'MCP 未初始化' } };
+  }
+  return await this._send('resources/subscribe', {
+    uri
+  });
+};
+
+/**
+ * 取消订阅服务端提供的数据资源（如数据库表、文件路径等）。
+ * @param {string} uri - 资源URI
+ * @returns {object} - 响应对象
+ */
+MCP.prototype.unsubscribeResource = async function (uri) {
+  if (!this.can_req) {
+    return { error: { code: 400, message: 'MCP 未初始化' } };
+  }
+  return await this._send('resources/unsubscribe', {
+    uri
+  });
+};
+
+/**
+ * 设置日志级别，用于控制服务端日志记录的详细程度。
+ * @param {string} level - 日志级别（如'info'、'debug'、'error'等）
+ * @returns {object} - 响应对象
+ */
+MCP.prototype.setLogLevel = async function (level) {
+  if (!this.can_req) {
+    return { error: { code: 400, message: 'MCP 未初始化' } };
+  }
+  return await this._send('logging/setLevel', {
+    level
+  });
+};
+
+/**
+ * 发送通知消息，用于向服务端发送通知事件（如工具调用结果、数据资源变更等）。
+ * @param {string} level - 通知级别（如'info'、'debug'、'error'等）
+ * @param {string} log - 通知日志（如工具调用结果、数据资源变更等）
+ * @param {object} data - 通知数据对象
+ * @returns {object} - 响应对象
+ */
+MCP.prototype.sendNotification = async function (level, log, data) {
+  if (!this.can_req) {
+    return { error: { code: 400, message: 'MCP 未初始化' } };
+  }
+  return await this._send('notifications/message', {
+    level: level,
+    log: log,
+    data: data
+  });
+};
+
+/**
+ * 获取通知列表，列出服务端可提供的通知事件（如工具调用结果、数据资源变更等）。
+ * @param {Array} messages - 消息对象数组
+ * @param {object} model_preferences - 模型偏好对象
+ * @param {string} system_prompt - 系统提示词
+ * @param {string} include_context - 是否包含上下文（如'none'、'all'、'current'等）
+ * @returns {object} - 响应对象
+ */
+MCP.prototype.createMessageSampling = async function (messages, model_preferences = null, system_prompt = '', include_context = '') {
+  if (!this.can_req) {
+    return { error: { code: 400, message: 'MCP 未初始化' } };
+  }
+  let query = {
+    messages: messages
+  };
+  if (model_preferences) {
+    query.modelPreferences = model_preferences;
+  }
+  if (system_prompt) {
+    query.systemPrompt = system_prompt;
+  }
+  if (include_context) {
+    query.includeContext = include_context;
+  }
+  return await this._send('sampling/createMessage', query);
+};
+
+/**
+ * 参数补全，提供参数值的自动补全。
+ * @param {string} ref - 引用ID
+ * @param {object} argument - 完成参数对象
+ * @returns {object} - 响应对象
+ */
+MCP.prototype.completeCompletion = async function (ref, argument) {
+  if (!this.can_req) {
+    return { error: { code: 400, message: 'MCP 未初始化' } };
+  }
+  return await this._send('completion/complete', {
+    ref: ref,
+    argument: argument
+  });
+};
+
+module.exports = {
+  MCP
+};

package/core/mcp/server.js

@@ -0,0 +1,186 @@
+const Koa = require('koa');
+const send = require('koa-send');
+const { koaBody } = require('koa-body');
+const { Drive } = require('mm_machine');
+
+/**
+ * MCP服务端，用于构建MCP协议的服务器端
+ */
+class Server extends Drive {
+  static config = {
+    host: '0.0.0.0',
+    port: 3000,
+    log: {
+      level: 'info'
+    }
+  };
+  
+  /**
+   * 构造函数
+   * @param {object} config - 配置参数
+   * @param {object} parent - 父级实例
+   */
+  constructor(config, parent) {
+    super({ ...Server.config, ...config }, parent);
+  }
+}
+
+/**
+ * 加载基础
+ */
+Server.prototype._loadBase = function () {
+  let web = this.web;
+  // 统一错误处理
+  web.use(async (ctx, next) => {
+    try {
+      await next();
+    } catch (error) {
+      this.log('error', error);
+    }
+  });
+
+  // 处理文件
+  web.use(async (ctx, next) => {
+    // 设置文件发送方法，错误由web_error中间件统一处理
+    ctx.send = async function (src) {
+      await send(ctx, src);
+    };
+    await next();
+  });
+
+  // 解析请求体
+  web.use(koaBody({
+    jsonLimit: cg.json_limit || '20mb',
+    multipart: true, // 必须开启才能解析 form-data
+    urlencoded: true, // 可选：解析 URL 编码的表单
+    text: true,
+    json: true, // 可选：解析 JSON
+    patchNode: true,
+    patchKoa: true,
+    formidable: {
+      maxFileSize: cg.max_file_size || 2000 * 1024 * 1024
+    }
+  }));
+};
+
+/**
+ * 初始化资源
+ */
+Server.prototype._initManager = function () {
+  this.web = new Koa();
+  this._loadBase();
+};
+
+/**
+ * 加载Api接口
+ */
+Server.prototype._loadApi = function () {
+  this._loadToolsApi();
+  this._loadApi();
+};
+
+/**
+ * 加载工具类接口
+ */
+Server.prototype._loadToolsApi = function () {
+  this.web.use(async (ctx, next) => {
+    if (ctx.method == 'GET') {
+      switch (ctx.path) {
+        case '/tools/call':
+          // 执行指定工具，传入参数，返回执行结果
+          break;
+        case '/tools/list':
+          // 返回所有可用工具的列表，包含名称、描述、参数 schema
+          break;
+        default:
+          break;
+      }
+    }
+  });
+};
+
+/**
+ * 加载资源类接口
+ */
+Server.prototype._loadResourcesApi = function () {
+  this.web.use(async (ctx, next) => {
+    if (ctx.path === '/resources/subscribe') {
+      // 订阅资源变更通知
+    } else if (ctx.path === '/resources/unsubscribe') {
+      // 取消订阅资源变更通知
+    } else if (ctx.method == 'GET') {
+      switch (ctx.path) {
+        case '/resources/read':
+          // 读取指定资源的内容
+          break;
+        case '/resources/list':
+          // 列出可用资源
+          break;
+        case '/resources/templates/list':
+          // 列出资源模板（支持动态 URI）
+          break;
+        default:
+          break;
+      }
+    }
+  });
+};
+
+/**
+ * 加载提示词类接口
+ */
+Server.prototype._loadPromptsApi = function () {
+  this.web.use(async (ctx, next) => {
+    if (ctx.method == 'GET') {
+      switch (ctx.path) {
+        // 获取指定提示词的内容和参数
+        case '/prompts/get':
+
+          break;
+        // 列出可用的提示词模板
+        case '/prompts/list':
+          break;
+        default:
+          break;
+      }
+    }
+  });
+};
+
+/**
+ * 加载辅助类接口
+ */
+Server.prototype._loadAuxiliaryApi = function () {
+  this.web.use(async (ctx, next) => {
+    if (ctx.method == 'GET') {
+      switch (ctx.path) {
+        // 提供参数自动补全（用于提示词或资源模板的参数）
+        case '/completion/complete':
+
+          break;
+        // 设置日志级别（可选）
+        case '/logging/setLevel':
+
+          break;
+        default:
+          break;
+      }
+    }
+  });
+};
+
+/**
+ * 加载通用接口
+ */
+Server.prototype._loadComApi = function () {
+  this.web.use(async (ctx, next) => {
+    if (ctx.path === '/mcp') {
+      if (ctx.method == 'POST') {
+        // 接收客户端发送的 JSON-RPC 请求/通知/响应。若请求需流式响应，返回 SSE 流；否则返回 JSO
+      }
+      else if (ctx.method == 'GET') {
+        // 可选，用于建立 SSE 长连接，接收服务端主动推送的消息
+      }
+    }
+  });
+};

package/core/project/about.md

@@ -0,0 +1,7 @@
+# 相关文档
+1. 项目需求文档
+2. 项目设计文档
+3. 项目实现文档
+4. 项目测试文档
+5. 项目部署文档
+6. 项目维护文档

package/core/project/config.tpl.json

@@ -0,0 +1,53 @@
+{
+  // 项目标识名称（唯一标识）
+  "name": "",
+  // 项目标题(显示用的中文名称)
+  "title": "默认项目",
+  // 项目描述
+  "description": "默认项目",
+  // 项目类型 例如：调研、开发、测试等
+  "type": "",
+  // 项目关键词 例如：ai、移动应用、视频生成等
+  "keywords": [],
+  // 项目根目录，所有文档和产出文件的根目录
+  "root_dir": "/project",
+  // 项目相关文档存放目录
+  "doc_dir": "./doc",
+  // 项目产出文件存放目录
+  "static_dir": "./static",
+  // 项目文件路径
+  "doc_file": "./project.md",
+  // 项目相关会话列表，涉及到此项目的会话ID列表
+  "sessions": {
+    // id => 状态：active、inactive、completed
+    // "default": "active"
+  },
+  // 项目负责人，团队领头，项目的发起者，有权让谁加入项目
+  "leader": "admin",
+  // 团队成员，参与的用户
+  "team": {
+    "admin": {
+      "title": "管理员",
+      "job": "项目负责人",
+      "work": "负责项目，包括项目计划、资源分配、客户沟通等。"
+    }
+  },
+  // 项目开始时间
+  "start_time": "",
+  // 项目结束时间
+  "end_time": "",
+  // 项目最终目标
+  "goal": "",
+  // 项目里程碑，每个包含：目标描述、达成日期、负责人（智能体）、状态
+  "milestone": [],
+  // 关键产物，项目完成时需要交付的成果
+  "products": [],
+  // 验收标准，项目完成时需要满足的条件，判断成功的关键指标
+  "criteria": [],
+  // 验收人，负责验证项目是否符合验收标准
+  "recipient": "admin",
+  // 项目状态 例如：未开始 / 进行中 / 已完成 / 已延期 / 已取消
+  "status": "",
+  // 优先级别: 1-9，1为最高，9为最低
+  "priority": 5
+}