Augent MCP 服务器

关键词

本地转写语义检索音频管理工具调用数据内存

使用说明（Markdown格式）

  • 项目简介

    • Augent 的 MCP 服务器实现，作为本地音频智能工具集在 MCP 客户端（如 Claude Code）中提供统一的工具注册、调用，以及对资源与提示模板的访问能力，全部在本地执行，确保隐私与离线能力。

  • 主要功能点

    • 提供并管理大量音频处理相关的工具（下载、转写、检索、语义搜索、笔记、章节检测、内存管理、导出等）。
    • 支持通过 MCP 协议接收请求、分发给内部处理函数，并返回标准化的 JSON-RPC 响应。
    • 具备完整的服务器实现能力：请求路由、工具注册、返回格式化、错误处理、可扩展的可选依赖加载。
    • 通过可选模块实现语义检索、分段高亮、导出格式（CSV/Excel/SRT/VTT/Markdown/JSON），以及内存与嵌入缓存等能力。
    • 设计上考虑了依赖可选加载（如语义模型、分离、TTS、分段等），在无相关依赖时仍可作为基本 MCP 服务使用。

  • 安装步骤

    • 确保 Python 环境就绪，并具备运行本 MCP 服务的依赖（如 faster_whisper、torch 等；若未安装，可按项目依赖安装）。
    • 运行服务器命令：
      • python -m augent.mcp
    • 服务器启动后，MCP 客户端（如 Claude Code）可通过以下配置与之对接，例如下列示例所示。

  • 服务器配置（给 MCP 客户端的连接信息，JSON 格式，包含 server name、command、args 等说明）

    • 客户端配置示例（JSON）： { "mcpServers": { "augent": { "command": "augent-mcp", "args": [] } } }
    • 注释说明：
      • serverName（示例中的键名为 augent，表示 MCP 服务器在客户端中的标识名）。
      • command：运行服务器的命令。此实现中推荐使用 augent-mcp（等价于执行 python -m augent.mcp）。
      • args：若有额外参数可在此填写；当前实现通常不强制要求额外参数，客户端可按需扩展。
    • 使用要点：为了与 Claude Code 等 MCP 客户端建立连接，请将上述配置导入到客户端的 MCP 设置中，重启相关客户端以使连接生效。

  • 基本使用方法

    • 启动后，客户端通过 MCP 协议向服务器发送 JSON-RPC 请求，包含 initialize、tools/list、tools/call 等方法。
    • 客户端可以获取工具列表、调用具体工具（如 transcribe_audio、search_audio、memory_stats、list_memories 等），服务器返回规范化的 JSON-RPC 响应。
    • 服务器负责会话管理、能力声明，以及对可选组件的动态加载，在无相关依赖时仍可提供基础的 MCP 服务。

服务器信息

访问项目