Skip to content

LeoYeAI/agent-master-skills / skills/agent-comm-hub

agent-comm-hub

Flagged

多智能体协同通信基础设施——基于 MCP+SSE 的实时消息、任务调度、记忆共享与进化引擎。支持 WorkBuddy、Hermes、QClaw 及任意 MCP 兼容 Agent 接入。53 个 MCP 工具、4 级权限、零外部依赖 Python SDK。触发词:agent通信、智能体通信、hub通信、多智能体、跨agent通信、任务调度、assign_task、send_message、hermes通信、workbuddy通信、agent hub、通信hub、mcp通信、记忆共享、进化引擎、策略共享、经验分享、共享记忆,共同进化

FileKindSize
.clawhub/origin.jsonconfig146 B
API_REFERENCE.mdmarkdown18.4 KB
HERMES-SETUP.mdmarkdown5.5 KB
README.mdmarkdown8.8 KB
SKILL.mdskill md16.4 KB
_meta.jsonconfig133 B
client-sdk/agent-client.d.tsscript11.6 KB
client-sdk/agent-client.jsscript28.6 KB
client-sdk/agent-client.tsscript29.8 KB
client-sdk/hermes-integration.d.tsscript785 B
client-sdk/hermes-integration.jsscript6.3 KB
client-sdk/hermes-integration.tsscript6.1 KB
client-sdk/hub_client.pyscript50.8 KB
client-sdk/workbuddy-integration.d.tsscript11 B
client-sdk/workbuddy-integration.jsscript4.3 KB
client-sdk/workbuddy-integration.tsscript4.2 KB
deploy/docker-compose.ymlconfig2.0 KB
deploy/grafana/dashboard.jsonconfig16.4 KB
deploy/grafana/provisioning/dashboards/dashboards.ymlconfig258 B
deploy/grafana/provisioning/datasources/prometheus.ymlconfig186 B
deploy/prometheus.ymlconfig408 B
docs/advanced-orchestration-guide.mdmarkdown11.8 KB
docs/evolution-engine-guide.mdmarkdown16.6 KB
docs/hermes-integration-guide.mdmarkdown22.3 KB
package-lock.jsonmanifest139.0 KB
package.jsonmanifest861 B
scripts/hub_task_runner.pyscript6.0 KB
scripts/hub_watcher.pyscript13.9 KB
scripts/install.shscript549 B
scripts/migrate_evolution_db.pyscript6.5 KB
scripts/migrate_from_agent.jsscript2.5 KB
scripts/wb_task_trigger.pyscript2.2 KB
src/db.d.tsscript3.7 KB
src/db.jsscript34.0 KB
src/db.tsscript37.4 KB
src/dedup.d.tsscript2.4 KB
src/dedup.jsscript8.5 KB
src/dedup.tsscript8.7 KB
src/errors.tsscript3.4 KB
src/evolution.d.tsscript6.6 KB
src/evolution.jsscript26.4 KB
src/evolution.tsscript31.0 KB
src/identity.d.tsscript3.4 KB
src/identity.jsscript15.9 KB
src/identity.tsscript17.1 KB
src/logger.d.tsscript1.1 KB
src/logger.jsscript2.8 KB
src/logger.tsscript3.5 KB
src/memory.d.tsscript2.1 KB
src/memory.jsscript13.0 KB
src/memory.tsscript14.3 KB
src/metrics.d.tsscript1.8 KB
src/metrics.jsscript8.4 KB
src/metrics.tsscript9.1 KB
src/orchestrator.d.tsscript6.1 KB
src/orchestrator.jsscript30.4 KB
src/orchestrator.tsscript33.4 KB
src/repo/interfaces.d.tsscript3.6 KB
src/repo/interfaces.jsscript49 B
src/repo/interfaces.tsscript4.2 KB
src/repo/sqlite-impl.d.tsscript225 B
src/repo/sqlite-impl.jsscript7.7 KB
src/repo/sqlite-impl.tsscript8.8 KB
src/repo/types.d.tsscript1021 B
src/repo/types.jsscript116 B
src/repo/types.tsscript1.6 KB
src/security.d.tsscript3.7 KB
src/security.jsscript15.0 KB
src/security.tsscript16.4 KB
src/server.d.tsscript11 B
src/server.jsscript24.7 KB
src/server.tsscript24.7 KB
src/sse.d.tsscript1.6 KB
src/sse.jsscript3.3 KB
src/sse.tsscript3.6 KB
src/stdio.d.tsscript11 B
src/stdio.jsscript1.7 KB
src/stdio.tsscript1.6 KB
src/tokenizer.d.tsscript1.3 KB
src/tokenizer.jsscript3.4 KB
src/tokenizer.tsscript3.2 KB
src/tools.d.tsscript474 B
src/tools.jsscript1.1 KB
src/tools.tsscript1.3 KB
src/tools/consumed.d.tsscript361 B
src/tools/consumed.jsscript5.5 KB
src/tools/consumed.tsscript5.3 KB
src/tools/evolution.d.tsscript660 B
src/tools/evolution.jsscript19.3 KB
src/tools/evolution.tsscript17.6 KB
src/tools/file.d.tsscript348 B
src/tools/file.jsscript7.1 KB
src/tools/file.tsscript6.5 KB
src/tools/identity.d.tsscript438 B
src/tools/identity.jsscript9.8 KB
src/tools/identity.tsscript9.3 KB
src/tools/memory.d.tsscript410 B
src/tools/memory.jsscript11.9 KB
src/tools/memory.tsscript10.8 KB
src/tools/message.d.tsscript467 B
src/tools/message.jsscript17.2 KB
src/tools/message.tsscript15.8 KB
src/tools/orchestrator.d.tsscript746 B
src/tools/orchestrator.jsscript27.8 KB
src/tools/orchestrator.tsscript24.3 KB
src/tools/security.d.tsscript386 B
src/tools/security.jsscript9.0 KB
src/tools/security.tsscript7.8 KB
src/types.tsscript5.9 KB
src/utils.d.tsscript421 B
src/utils.jsscript1.3 KB
src/utils.tsscript3.0 KB
tsconfig.jsonconfig337 B
vitest.config.tsscript1.2 KB

src/tools/file.ts

View on GitHub
/**
 * file.ts — 文件传输工具
 * Tools: upload_file, download_file, list_attachments
 */
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { z } from "zod";
import { randomUUID } from "crypto";
import { type Attachment, attachStmt } from "../db.js";
import { messageRepo } from "../repo/sqlite-impl.js";
import { pushToAgent } from "../sse.js";
import { type AuthContext } from "../security.js";
import { logError } from "../logger.js";
import { incrementMcpCall } from "../metrics.js";
import { existsSync, mkdirSync, writeFileSync, readFileSync } from "fs";
import { join as pathJoin } from "path";
import { withRetry, requireAuth, mcpError } from "../utils.js";

/**
 * 注册文件传输工具
 */
export function registerFileTools(server: McpServer, authContext?: AuthContext): void {

  // ═══════════════════════════════════════════════════════════════
  // v2.3 Phase 1.1: 文件传输工具(3 个)
  // ═══════════════════════════════════════════════════════════════

  // --- Tool: upload_file ---
  // 上传文件附件并关联到消息 — member 及以上
  server.tool(
    "upload_file",
    "上传文件附件并关联到消息。文件以 Base64 编码传入,服务端解码后存储到本地磁盘。",
    {
      message_id:     z.string().describe("关联的消息 ID"),
      filename:       z.string().describe("文件名(含扩展名)"),
      content_base64: z.string().describe("文件内容的 Base64 编码"),
      mime_type:      z.string().default("application/octet-stream").describe("MIME 类型"),
    },
    async ({ message_id, filename, content_base64, mime_type }) => {
      const ctx = requireAuth(authContext, "upload_file");
      try {
        // 验证消息存在
        const msg = messageRepo.getById(message_id);
        if (!msg) {
          return { content: [{ type: "text", text: JSON.stringify({ error: `Message ${message_id} not found` }) }] };
        }

        // Base64 解码
        const buffer = Buffer.from(content_base64, "base64");
        const fileSize = buffer.length;

        // 检查文件大小(10MB 限制)
        if (fileSize > 10 * 1024 * 1024) {
          return { content: [{ type: "text", text: JSON.stringify({ error: "File too large, max 10MB" }) }] };
        }

        // 生成存储路径
        const id = randomUUID();
        const uploadDir = process.env.UPLOAD_DIR || pathJoin(process.cwd(), "uploads");
        if (!existsSync(uploadDir)) mkdirSync(uploadDir, { recursive: true });
        const storagePath = pathJoin(uploadDir, id);

        // 写入文件
        writeFileSync(storagePath, buffer);

        // 存入数据库
        attachStmt.insert.run({
          id,
          message_id,
          filename,
          mime_type,
          file_size: fileSize,
          storage_path: storagePath,
          uploaded_by: ctx.agentId,
          created_at: Date.now(),
        });

        // SSE 通知接收方
        pushToAgent(msg.to_agent, {
          type: "file_attached",
          attachment_id: id,
          message_id,
          filename,
          mime_type,
          file_size: fileSize,
          uploaded_by: ctx.agentId,
          created_at: Date.now(),
        });

        incrementMcpCall("upload_file", "success", ctx.role);
        return {
          content: [{
            type: "text",
            text: JSON.stringify({
              success: true,
              attachment_id: id,
              filename,
              file_size: fileSize,
              message_id,
            }, null, 2),
          }],
        };
      } catch (err: unknown) {
        logError("upload_file_error", err);
        return mcpError(err, "upload_file");
      }
    }
  );

  // --- Tool: download_file ---
  // 下载附件,返回 Base64 编码 — member 及以上
  server.tool(
    "download_file",
    "下载附件,返回 Base64 编码的文件内容。",
    {
      attachment_id: z.string().describe("附件 ID"),
    },
    async ({ attachment_id }) => {
      const ctx = requireAuth(authContext, "download_file");
      try {
        const attach = attachStmt.getById.get(attachment_id) as Attachment | undefined;
        if (!attach) {
          return { content: [{ type: "text", text: JSON.stringify({ error: `Attachment ${attachment_id} not found` }) }] };
        }
        if (!existsSync(attach.storage_path)) {
          return { content: [{ type: "text", text: JSON.stringify({ error: "File not found on disk" }) }] };
        }
        const buffer = readFileSync(attach.storage_path);
        incrementMcpCall("download_file", "success", ctx.role);
        return {
          content: [{
            type: "text",
            text: JSON.stringify({
              success: true,
              attachment_id: attach.id,
              filename: attach.filename,
              mime_type: attach.mime_type,
              file_size: attach.file_size,
              content_base64: buffer.toString("base64"),
              message_id: attach.message_id,
            }, null, 2),
          }],
        };
      } catch (err: unknown) {
        logError("download_file_error", err);
        return mcpError(err, "download_file");
      }
    }
  );

  // --- Tool: list_attachments ---
  // 列出消息的附件列表 — member 及以上
  server.tool(
    "list_attachments",
    "列出消息的所有附件列表。",
    {
      message_id: z.string().describe("消息 ID"),
    },
    async ({ message_id }) => {
      const ctx = requireAuth(authContext, "list_attachments");
      try {
        const attachments = attachStmt.listByMessage.all(message_id) as Attachment[];
        incrementMcpCall("list_attachments", "success", ctx.role);
        return {
          content: [{
            type: "text",
            text: JSON.stringify({
              message_id,
              attachments: attachments.map(a => ({
                id: a.id,
                filename: a.filename,
                mime_type: a.mime_type,
                file_size: a.file_size,
                uploaded_by: a.uploaded_by,
                created_at: a.created_at,
              })),
              count: attachments.length,
            }, null, 2),
          }],
        };
      } catch (err: unknown) {
        logError("list_attachments_error", err);
        return mcpError(err, "list_attachments");
      }
    }
  );
}
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall