mcp_llm-debate 1.0.0

package/SERVER_METADATA.json

@@ -0,0 +1,6 @@
+{
+  "name": "mcp_llm-debate",
+  "description": "多 LLM 辩论系统 - 支持多种辩论模式，多个 AI 角色就同一主题进行结构化辩论",
+  "source": "local",
+  "toolCount": 5
+}

package/graphs/brainstorming.json

@@ -0,0 +1,50 @@
+{
+  "name": "brainstorming",
+  "description": "头脑风暴模式：多角色自由发散，产生创意和灵感",
+  "roles": [
+    {
+      "name": "facilitator",
+      "persona": "你是引导者，负责提出头脑风暴的主题和方向。鼓励大家大胆提出想法，不做评判。记录有价值的创意，引导讨论走向深入。确保每个人都有发言机会。"
+    },
+    {
+      "name": "visionary",
+      "persona": "你是远见者，思维方式天马行空。你擅长提出大胆的、颠覆性的想法，不受现有条件限制。你的价值在于突破思维定式，提供全新的视角。"
+    },
+    {
+      "name": "realist",
+      "persona": "你是务实者，关注想法的可行性和落地路径。你会思考如何把创意转化为实际方案，指出实施中的关键挑战和资源需求。你的质疑是为了让想法更可行。"
+    },
+    {
+      "name": "critic",
+      "persona": "你是批判者，负责从不同角度审视每个想法。你发现潜在风险、盲点和逻辑漏洞。你的目的是帮助团队提前发现问题，避免走弯路。保持建设性而非否定性。"
+    }
+  ],
+  "rounds": [
+    {
+      "phase": "divergent",
+      "speakers": ["visionary", "realist", "critic"],
+      "description": "发散阶段：各角色自由提出想法和观点，不做评判"
+    },
+    {
+      "phase": "convergent",
+      "speakers": ["facilitator", "visionary", "realist", "critic"],
+      "description": "收敛阶段：对提出的想法进行初步讨论和筛选"
+    },
+    {
+      "phase": "deepening",
+      "speakers": ["visionary", "realist", "critic"],
+      "description": "深化阶段：对有潜力的想法进行深度探讨和完善"
+    },
+    {
+      "phase": "synthesis",
+      "speakers": ["facilitator"],
+      "description": "综合阶段：引导者总结所有创意，形成可行性评估"
+    }
+  ],
+  "rules": {
+    "max_rounds": 4,
+    "turn_limit": 3,
+    "min_response_length": 30,
+    "requires_fact_checking": false
+  }
+}

package/graphs/classic-debate.json

@@ -0,0 +1,54 @@
+{
+  "name": "classic-debate",
+  "description": "经典辩论模式：正方 vs 反方 + 评审裁决",
+  "roles": [
+    {
+      "name": "proponent",
+      "model": "deepseek-ai/DeepSeek-V4-Flash",
+      "persona": "你是正方辩手，你坚定支持该主题观点。你需要基于事实数据、逻辑推理和权威引用进行论证。你的目标是说服评审和听众接受你的立场。"
+    },
+    {
+      "name": "opponent",
+      "model": "moonshotai/Kimi-K2.7-Code",
+      "persona": "你是反方辩手，你对该主题观点持批判态度。你需要找出观点中的漏洞、逻辑矛盾和不合理之处。你的目标是通过有力质疑来动摇正方立场。"
+    },
+    {
+      "name": "judge",
+      "model": "zai-org/GLM-5.2",
+      "persona": "你是中立评审，不偏袒任何一方。你需要客观评估双方论据的充分性、逻辑性和说服力。最终基于论证质量做出裁决，并给出详细理由。"
+    }
+  ],
+  "rounds": [
+    {
+      "phase": "opening",
+      "speakers": ["proponent", "opponent"],
+      "description": "开场陈述：双方分别陈述核心观点和主要论据"
+    },
+    {
+      "phase": "rebuttal",
+      "speakers": ["opponent", "proponent"],
+      "description": "反驳环节：双方针对对方的开场陈述进行反驳"
+    },
+    {
+      "phase": "cross_examination",
+      "speakers": ["proponent", "opponent"],
+      "description": "交叉质询：双方深入交锋，质疑对方的论据和逻辑"
+    },
+    {
+      "phase": "closing",
+      "speakers": ["proponent", "opponent"],
+      "description": "总结陈词：双方总结核心论点并做最后陈述"
+    },
+    {
+      "phase": "verdict",
+      "speakers": ["judge"],
+      "description": "评审裁决：评审评估双方表现并宣布结果"
+    }
+  ],
+  "rules": {
+    "max_rounds": 5,
+    "turn_limit": 2,
+    "min_response_length": 100,
+    "requires_fact_checking": true
+  }
+}

package/graphs/panel-discussion.json

@@ -0,0 +1,55 @@
+{
+  "name": "panel-discussion",
+  "description": "小组讨论模式：多位不同领域专家围绕主题展开讨论，由主持人引导",
+  "roles": [
+    {
+      "name": "host",
+      "persona": "你是主持人，负责引导讨论节奏、控制时间、确保每位专家都有发言机会。你需要在关键节点提出引导性问题，并总结各专家的观点。保持中立客观。"
+    },
+    {
+      "name": "technology_expert",
+      "persona": "你是技术专家，从技术可行性、创新趋势和工程实践角度分析该主题。关注技术细节、实现路径和潜在技术风险。"
+    },
+    {
+      "name": "business_expert",
+      "persona": "你是商业专家，从商业模式、市场趋势、投资回报和产业影响角度分析该主题。关注经济效益、市场竞争和商业可行性。"
+    },
+    {
+      "name": "ethics_expert",
+      "persona": "你是伦理与社会影响专家，从道德伦理、社会公平、法律法规和人文关怀角度分析该主题。关注潜在的社会影响和伦理风险。"
+    }
+  ],
+  "rounds": [
+    {
+      "phase": "introduction",
+      "speakers": ["host"],
+      "description": "主持人介绍主题和各位专家"
+    },
+    {
+      "phase": "expert_opinions",
+      "speakers": ["technology_expert", "business_expert", "ethics_expert"],
+      "description": "专家各自从专业角度发表观点"
+    },
+    {
+      "phase": "cross_discussion",
+      "speakers": ["technology_expert", "business_expert", "ethics_expert"],
+      "description": "跨领域讨论：专家之间相互提问和回应"
+    },
+    {
+      "phase": "deep_dive",
+      "speakers": ["host", "technology_expert", "business_expert", "ethics_expert"],
+      "description": "深入探讨：主持人引导专家对核心争议点进行深入分析"
+    },
+    {
+      "phase": "summary",
+      "speakers": ["host"],
+      "description": "主持人总结各位专家观点，形成综合结论"
+    }
+  ],
+  "rules": {
+    "max_rounds": 5,
+    "turn_limit": 3,
+    "min_response_length": 80,
+    "requires_fact_checking": true
+  }
+}

package/graphs/socratic-dialogue.json

@@ -0,0 +1,51 @@
+{
+  "name": "socratic-dialogue",
+  "description": "苏格拉底式对话：通过持续提问和辩证思考来探索真理",
+  "roles": [
+    {
+      "name": "questioner",
+      "persona": "你是提问者，效仿苏格拉底的方法。你不直接给出答案，而是通过一系列深入追问来引导对方思考。你的问题应当层层递进，揭露假设、矛盾和未深思之处。保持好奇但友善的态度。"
+    },
+    {
+      "name": "respondent",
+      "persona": "你是回应者，诚实地回答提问者的问题。你应当深入思考每个问题，承认自己知识的局限性，并努力澄清自己的观点。愿意在逻辑面前修正自己的立场。"
+    },
+    {
+      "name": "observer",
+      "persona": "你是观察者，旁观整个对话过程。你需要在对话结束时，总结对话中揭示的关键洞见、逻辑矛盾和思维突破。提供客观的第三方视角分析。"
+    }
+  ],
+  "rounds": [
+    {
+      "phase": "initial_statement",
+      "speakers": ["respondent"],
+      "description": "回应者陈述初始观点或立场"
+    },
+    {
+      "phase": "questioning_round_1",
+      "speakers": ["questioner", "respondent"],
+      "description": "第一轮问答：提问者对核心假设进行初步质疑"
+    },
+    {
+      "phase": "questioning_round_2",
+      "speakers": ["questioner", "respondent"],
+      "description": "第二轮问答：深入追问概念定义和逻辑基础"
+    },
+    {
+      "phase": "questioning_round_3",
+      "speakers": ["questioner", "respondent"],
+      "description": "第三轮问答：探讨隐含前提和可能的反例"
+    },
+    {
+      "phase": "observation",
+      "speakers": ["observer"],
+      "description": "观察者总结对话成果、洞见和未解决的问题"
+    }
+  ],
+  "rules": {
+    "max_rounds": 5,
+    "turn_limit": 3,
+    "min_response_length": 50,
+    "requires_fact_checking": false
+  }
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "mcp_llm-debate",
+  "version": "1.0.0",
+  "description": "多 LLM 辩论系统 - 支持多种辩论模式，可作为 MCP 插件、HTTP 服务或 npm 库使用",
+  "type": "module",
+  "main": "./src/lib.js",
+  "bin": {
+    "mcp_llm-debate": "./src/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./src/lib.js"
+    },
+    "./config": {
+      "import": "./src/config.js"
+    },
+    "./debate-engine": {
+      "import": "./src/debate-engine.js"
+    },
+    "./llm-client": {
+      "import": "./src/llm-client.js"
+    },
+    "./session-manager": {
+      "import": "./src/session-manager.js"
+    },
+    "./graph-loader": {
+      "import": "./src/graph-loader.js"
+    }
+  },
+  "scripts": {
+    "start": "node src/cli.js",
+    "start:http": "node src/cli.js --transport http",
+    "start:rest": "node src/cli.js --transport rest",
+    "test": "node src/test.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "llm",
+    "debate",
+    "ai",
+    "multi-agent",
+    "model-context-protocol",
+    "discussion",
+    "brainstorming"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  }
+}

package/src/cli.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+
+/**
+ * mcp_llm-debate CLI 入口
+ *
+ * 支持三种传输方式：
+ *   npx mcp_llm-debate                           # stdio 模式（默认）
+ *   npx mcp_llm-debate --transport http --port 3000   # MCP HTTP 模式
+ *   npx mcp_llm-debate --transport rest --port 3000   # REST API 模式
+ *
+ * 环境变量：
+ *   LLM_API_KEY, LLM_BASE_URL, LLM_MODEL
+ *   SERVER_TRANSPORT, SERVER_PORT, SERVER_HOST
+ */
+
+import { createToolContext, createServer, executeTool } from './index.js';
+import { loadConfig } from './config.js';
+import { startHTTPServer } from './transports/http.js';
+import { startRESTServer } from './transports/rest.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+
+/**
+ * 解析命令行参数
+ */
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const opts = {};
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    switch (arg) {
+      case '--transport':
+      case '-t':
+        opts.transport = args[++i];
+        break;
+      case '--port':
+      case '-p':
+        opts.port = parseInt(args[++i], 10);
+        break;
+      case '--host':
+      case '-h':
+        opts.host = args[++i];
+        break;
+      case '--help':
+        printHelp();
+        process.exit(0);
+        break;
+      default:
+        if (arg.startsWith('--')) {
+          console.error(`未知参数: ${arg}`);
+          printHelp();
+          process.exit(1);
+        }
+    }
+  }
+
+  return opts;
+}
+
+function printHelp() {
+  console.log(`
+mcp_llm-debate - 多 LLM 辩论系统
+
+用法:
+  npx mcp_llm-debate [选项]
+
+选项:
+  --transport, -t <mode>   传输方式: stdio | http | rest (默认: stdio)
+  --port, -p <number>      HTTP/REST 监听端口 (默认: 3000)
+  --host <address>         绑定地址 (默认: 127.0.0.1)
+  --help                   显示帮助信息
+
+环境变量:
+  LLM_API_KEY              LLM API 密钥（必填）
+  LLM_BASE_URL             API 基础 URL
+  LLM_MODEL                模型名称
+  SERVER_TRANSPORT         传输方式
+  SERVER_PORT              HTTP/REST 端口
+  SERVER_HOST              绑定地址
+
+示例:
+  npx mcp_llm-debate                                    # stdio 模式
+  npx mcp_llm-debate --transport http --port 3000        # MCP HTTP 模式
+  npx mcp_llm-debate --transport rest --port 8080        # REST API 模式
+`);
+}
+
+// ============================================================
+// 主函数
+// ============================================================
+
+async function main() {
+  const cliArgs = parseArgs();
+  const config = loadConfig(cliArgs);
+  const transport = config.transport;
+
+  // 显示配置信息
+  console.error(`mcp_llm-debate v1.0.0`);
+  console.error(`传输方式: ${transport}`);
+  if (!config.apiKey) {
+    console.error('警告: 未配置 LLM API 密钥。请设置环境变量 LLM_API_KEY 或 OPENAI_API_KEY。');
+  }
+  console.error(`LLM 模型: ${config.model}`);
+
+  // 创建工具上下文
+  const ctx = createToolContext(config);
+
+  switch (transport) {
+    // ---- stdio 模式 ----
+    case 'stdio': {
+      console.error('启动 stdio 模式...');
+      const server = createServer(ctx);
+      const stdioTransport = new StdioServerTransport();
+      await server.connect(stdioTransport);
+      console.error('mcp_llm-debate 服务器已就绪');
+      break;
+    }
+
+    // ---- MCP HTTP 模式 ----
+    case 'http': {
+      console.error(`启动 MCP HTTP 模式，端口: ${config.port}...`);
+      const server = createServer(ctx);
+      await startHTTPServer(server, { port: config.port, host: config.host, authToken: config.authToken });
+      break;
+    }
+
+    // ---- REST API 模式 ----
+    case 'rest': {
+      console.error(`启动 REST API 模式，端口: ${config.port}...`);
+      await startRESTServer(
+        async (toolName, args) => await executeTool(toolName, args, ctx),
+        { port: config.port, host: config.host, authToken: config.authToken }
+      );
+      break;
+    }
+
+    default:
+      console.error(`不支持的传输方式: "${transport}"，有效值: stdio, http, rest`);
+      process.exit(1);
+  }
+}
+
+main().catch((error) => {
+  console.error('服务器启动失败:', error);
+  process.exit(1);
+});

package/src/config.js

@@ -0,0 +1,62 @@
+/**
+ * 统一配置管理
+ *
+ * 配置优先级：构造函数参数 > 环境变量 > 默认值
+ *
+ * 支持的配置项：
+ *   LLM_API_KEY    - LLM API 密钥
+ *   LLM_BASE_URL   - API 基础 URL（默认: https://api.openai.com/v1）
+ *   LLM_MODEL      - 模型名称（默认: gpt-4o）
+ *   AUTH_TOKEN     - HTTP/REST API 认证令牌（设置后强制要求 Bearer Token 鉴权）
+ *   SERVER_PORT    - HTTP/REST 服务器端口（默认: 3000）
+ *   SERVER_HOST    - 服务器绑定地址（默认: 127.0.0.1）
+ *   DATA_DIR       - Session 数据存储目录（默认: ./data）
+ *   GRAPHS_DIR     - 辩论图模板目录（默认: ./graphs）
+ */
+
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ROOT_DIR = path.join(__dirname, '..');
+
+/**
+ * 从环境变量和默认值加载配置
+ * @param {Object} overrides - 构造函数覆盖参数
+ * @returns {Object} 合并后的配置
+ */
+export function loadConfig(overrides = {}) {
+  const env = process.env;
+
+  return {
+    // LLM 配置
+    apiKey: overrides.apiKey ?? env.LLM_API_KEY ?? env.OPENAI_API_KEY ?? '',
+    baseUrl: overrides.baseUrl ?? env.LLM_BASE_URL ?? 'https://api.openai.com/v1',
+    model: overrides.model ?? env.LLM_MODEL ?? 'gpt-4o',
+
+    // 服务器配置
+    port: overrides.port ?? parseInt(env.SERVER_PORT || '3000', 10),
+    host: overrides.host ?? env.SERVER_HOST ?? '127.0.0.1',
+
+    // 认证配置（设置后 HTTP/REST 模式强制要求 Bearer Token）
+    authToken: overrides.authToken ?? env.AUTH_TOKEN ?? '',
+
+    // 传输方式：'stdio' | 'http' | 'rest'
+    transport: overrides.transport ?? env.SERVER_TRANSPORT ?? 'stdio',
+
+    // 数据目录
+    dataDir: overrides.dataDir ?? env.DATA_DIR ?? path.join(ROOT_DIR, 'data'),
+    graphsDir: overrides.graphsDir ?? env.GRAPHS_DIR ?? path.join(ROOT_DIR, 'graphs'),
+  };
+}
+
+/**
+ * 创建 LLMClient 所需的配置子集
+ */
+export function getLLMConfig(config) {
+  return {
+    apiKey: config.apiKey,
+    baseUrl: config.baseUrl,
+    model: config.model,
+  };
+}