AudioReader MCP Server

关键词

音频生成工具暴露LLM 集成服务端执行模型上下文

使用说明（Markdown 格式）

  • 项目简介

    • AudioReader 提供一个 MCP 服务器实现，允许 LLM 客户端通过统一的 MCP 接口注册、查询和执行工具，以及访问后端资源和提示模板等能力。
    • 通过 MCP 服务器，LLM 可以读取资源、执行工具（如文本分析、音频生成等）以及获取和渲染提示模板，形成与模型交互的安全、可扩展的后端上下文服务。

  • 主要功能点

    • 注册并暴露工具（Tools）：列出可用工具及其输入输出格式，支持查询、调用等交互。
    • 工具执行能力：实现了 list_voices、generate_audio、generate_audiobook、analyze_text、get_config、set_config、list_output_files 等工具，供客户端按需调用。
    • 脚本化与异步处理：工具方法以异步形式接入，支持 Claude Desktop/ Claude AI 等客户端的 JSON-RPC 风格请求。
    • 服务器端能力声明与会话管理：维护工具列表、执行上下文、输出结果与错误信息，便于客户端进行状态追踪。
    • 传输协议灵活性：MCP 服务器通过标准 MCP 机制（基于 mcp 库）实现与客户端的通信（包括 stdio 传输等场景）。

  • 安装步骤（简化版）

    • 安装 MCP：pip install mcp
    • 直接运行 MCP 服务器脚本：
      • python mcp_server.py
    • 服务器启动后，Claude Desktop（或其他 MCP 客户端）可以通过配置文件连接到该 MCP 服务器，进行工具查询与调用。

  • 服务器配置（MCP 客户端需要的信息，示例以 JSON 表示配置项）

    • 服务器名称（serverName）：AudioReader-MCP
    • 启动命令（command）：python
    • 参数（args）：["mcp_server.py"]
    • 工作目录（workingDirectory）："/path/to/AudioReader" 说明：以上配置用于 Claude Desktop 等 MCP 客户端在本地或服务器上启动并连接 MCP 服务。MCP 客户端不需要额外的代码实现，只需要知道服务器的启动命令与工作路径即可与 MCP 服务器建立通信。

  • 基本使用方法

    • 启动 MCP 服务器：在包含 mcp_server.py 的目录运行 python mcp_server.py
    • 配置 MCP 客户端：在 Claude Desktop/Claude AI 等客户端创建新的 MCP Server 配置，填入服务器名称、启动命令和参数信息（如上所示的 JSON 配置要点），客户端将与 MCP 服务器进行交互。
    • 使用工具：在客户端调用 list_tools 获取工具列表，然后通过 call_tool 提交请求、传入所需的输入参数，服务器返回相应的执行结果或错误信息。
    • 运行时注意事项：确保 MCP 服务器所在环境具备所需依赖，且服务可从客户端访问（本地或远程连接取决于部署方式）。

服务器信息

访问项目