Ktalk MCP

ktalk mcp

记录访问MCP服务器 轮廓好处 （KTalk）из克劳德代码。

提供访问：

• 会议记录列表
• 记录细节
• 转录（发言者识别演讲）
• 萨马拉和会议记录

安装

需要Python 3.12+和 紫外线.

uv tool install ktalk-mcp

通过PIP：

pip install ktalk-mcp

获取会话令牌

KTalk使用会话令牌授权API请求。代币作为查询参数传递。

1. 打开https://your-domain.ktalk.ru在浏览器中
2. 登录您的帐户
3. 打开DevTools：点击 F12 （或） Cmd+Option+I （Mac）
4. 单击选项卡 应用 → Cookie → https://your-domain.ktalk.ru
5. 查找带有名称的Cookie sessionToken
6. 复制其值

重要的是： Session Token的寿命有限。如果MCP工具返回授权错误，请按照上面的说明获取新令牌。

连接Claude Code

添加到文件 ~/.claude/.mcp.json （全球）或 .mcp.json （项目中）：

{
  "mcpServers": {
    "ktalk": {
      "command": "uvx",
      "args": ["ktalk-mcp"],
      "env": {
        "KTALK_SESSION_TOKEN": "ваш_session_token",
        "KTALK_BASE_URL": "https://your-domain.ktalk.ru"
      }
    }
  }
}

替代配置

您可以单独指定环境变量：

export KTALK_SESSION_TOKEN="ваш_session_token"
export KTALK_BASE_URL="https://your-domain.ktalk.ru"

也支持文件 .env 在工作目录中：

KTALK_SESSION_TOKEN=ваш_session_token
KTALK_BASE_URL=https://your-domain.ktalk.ru

可用的MCP工具

ktalk_list_recordings

会议记录列表。

≫参数≫类型≫默认≫描述≫ |----------|-----|---------|----------| | query 搜索标题，房间，作者 | start_from | str | — | 周期开始 （ISO 8601） | | start_to | str | — | 期末 | | top ≫int≫30≫记录数（1–1000）≫ | order ÐÐÐÐÐÐÐÐÐÐÐÐÐ byTimeNewFirst, byTimeOldFirst, byTitle, bySizeBigFirst, bySizeSmallFirst | | page_token | str | — | 分页令牌 | | format |str | markdown |原始/标记|

ktalk_get_recording

一个条目的细节-作者，日期，持续时间，参与者列表。

≫参数≫类型≫默认≫描述≫ |----------|-----|---------|----------| | recording_key –str––记录密钥（ID）。 | format |str | markdown |原始/标记|

ktalk_get_transcript

录音转录-语音识别与定时器。

支持 长金 对于长转录：当超过 chunk_size 答案会自动按副本的边界分割（而不是在短语的中间）。每个Chank都包含用于逐页读取的元数据。

≫参数≫类型≫默认≫描述≫ |----------|-----|---------|----------| | recording_key –str––记录密钥（ID）。 | format |str | markdown |原始/标记| | chunk ÐÐÐÐÐÐÐÐÐÐÐ。0=汽车（如果是小的，第一个Chank如果是大的）。1+=具体的Chank | chunk_size ÐÐÐÐÐÐÐÐÐÐÐ钱卡中的符号（~7500个代币）。软限制-在复制的边界上切割›

ktalk_get_summary

完整的Sammari记录（简短摘要+协议）。

≫参数≫类型≫默认≫描述≫ |----------|-----|---------|----------| | recording_key –str––记录密钥（ID）。 | format |str | markdown |原始/标记|

ktalk_get_summary_by_type

Sammari特定类型

≫参数≫类型≫默认≫描述≫ |----------|-----|---------|----------| | recording_key –str––记录密钥（ID）。 | summary_type |str |--| shortSummary / protocol | | format |str | markdown |原始/标记|

API

该服务器支持KTalk Web API。授权-通过 sessionToken 查询参数。

Endpoint描述 |----------|----------| | GET /api/recordings 记录列表 | GET /api/recordings/{id} 记录的细节 | GET /api/recordings/{id}/transcript | 转录 | | GET /api/recordings/v2/{id}/summary 完整的Sammari（v2） | GET /api/recordings/{id}/summary/{type} Sammari的类型

OpenAPI规范 talk.public.api-api-2.json 作为目录包含，但包含与实际API（路径、授权格式、响应结构）的差异。

开发

git clone https://github.com/mdemyanov/ktalk-mcp.git
cd ktalk-mcp
uv sync

# Запуск тестов
uv run pytest -v

# Линтинг
uv run ruff check .

# Локальный запуск сервера
KTALK_SESSION_TOKEN=... KTALK_BASE_URL=... uv run ktalk-mcp

许可证

麻省理工学院