使用说明

项目简介

Votars MCP 服务器是 Votars AI 平台提供的 MCP (Model Context Protocol) 服务器实现，旨在为大型语言模型 (LLM) 应用提供与 Votars 平台的无缝集成。通过该服务器，LLM 可以安全、可扩展地访问 Votars 平台上的会议录音转写记录，并调用预置的工具来获取信息，从而增强 LLM 在会议场景下的应用能力。目前该服务器提供 Go 语言版本，支持 SSE (Server-Sent Events) 和 Stdio (Standard Input/Output) 两种通信模式。

主要功能点

资源访问: 提供访问 Votars 平台会议转写记录的能力。
- 支持获取最近的转写记录。
- 支持通过转写记录 ID 获取指定的转写记录。
工具集成: 内置 'Votars_fetch_recent_transcripts' 和 'Votars_fetch_a_specific_transcript' 两个工具，方便 LLM 客户端调用以获取转写数据。
多种通信模式: 支持 SSE 和 Stdio 两种传输协议，适应不同的应用场景和部署环境。
易于集成: 可以通过 Smithery 或手动方式快速安装，并提供详细的配置和使用说明。

安装步骤

本仓库提供 Go 语言版本的 MCP 服务器。

方法一：通过 Smithery 安装 (Claude 客户端) 如果您使用 Claude 客户端，可以使用 Smithery 自动化安装 Votars MCP 服务器：

npx -y @smithery/cli install @scarletlabs-ai/votars-mcp --client claude

方法二：手动安装 (Go) 确保您已安装 Go 语言环境。使用以下命令手动安装 Votars MCP 服务器：

go install github.com/scarletlabs-ai/Votars-MCP/go/votars-mcp@latest

安装成功后，'votars-mcp' 可执行文件通常会位于 '$GOPATH/bin' 目录下。请确保该目录已添加到您的系统环境变量 'PATH' 中。

服务器配置

MCP 客户端需要配置连接 Votars MCP 服务器的信息。以下是 'mcp.config.json' 配置文件的示例，分别针对 SSE 和 Stdio 模式：

1. SSE 模式配置

{
  "mcpServers": {
    "Votars MCP SSE": {  // 服务器名称，可自定义
      "type": "sse",   // 连接类型，指定为 SSE
      "url": "http://0.0.0.0:8080/sse",  // MCP 服务器 SSE 接口的 URL，默认为 http://0.0.0.0:8080/sse
      "headers": {     // HTTP 请求头
        "Authorization": "Bearer <your-api-key>"  //  Votars API Key，用于身份验证，请替换为您的 API Key
      }
    }
  }
}

2. Stdio 模式配置

{
  "mcpServers": {
    "Votars MCP Stdio": { // 服务器名称，可自定义
      "type": "stdio",  // 连接类型，指定为 Stdio
      "command": "votars-mcp", // 启动 MCP 服务器的命令，这里假设 votars-mcp 可执行文件已在 PATH 环境变量中
      "args": ["-t", "stdio"], // 传递给 votars-mcp 命令的参数，指定使用 Stdio 传输模式
      "env": {        // 环境变量
        "VOTARS_API_KEY": "<your-api-key>" // Votars API Key，通过环境变量传递，请替换为您的 API Key
      }
    }
  }
}

API Key 获取

访问 Votars.AI 并注册账号。
进入您的工作区设置 (Settings)。
在 API Key 管理部分创建 API Key。

基本使用方法

1. 启动 MCP 服务器 根据您选择的通信模式，启动 Votars MCP 服务器。

SSE 模式: 打开终端，执行以下命令启动 SSE 模式的服务器，监听 8080 端口：

votars-mcp -t sse -p 8080

Stdio 模式: 打开终端，执行以下命令启动 Stdio 模式的服务器：

votars-mcp -t stdio

在 Stdio 模式下，您需要在运行 MCP 客户端的环境中设置 'VOTARS_API_KEY' 环境变量。

2. 配置 MCP 客户端 根据您使用的 MCP 客户端 (例如 Claude)，配置 'mcp.config.json' 文件，填入相应的服务器连接信息（如上述示例）。确保 API Key 配置正确。

3. 使用 LLM 客户端调用工具 在 LLM 客户端中，您可以指示 LLM 调用 'Votars_fetch_recent_transcripts' 或 'Votars_fetch_a_specific_transcript' 工具来获取 Votars 平台的转写记录。具体的调用方式取决于您使用的 LLM 客户端和提示词设计。

例如，在提示词中可以指示 LLM：

"请使用 'Votars_fetch_recent_transcripts' 工具获取最近的会议记录。"
"请使用 'Votars_fetch_a_specific_transcript' 工具，transcript ID 为 12345，获取该记录的内容。"

关键词