Docsie

Name: Docsie
Author: LikaloLLC

本地服务

github.com/LikaloLLC记忆与知识029 周前更新

代码仓库

关于 Docsie

Docsie 是面向 Claude 用户的远程 MCP 服务，可将视频链接转换为结构化 Markdown 文档。支持用户指南、SOP、产品文档、政策和博客等文档类型，并使用 OAuth2 认证。

主要功能

01根据视频链接生成结构化文档
02支持 YouTube、Loom、Vimeo 和 MP4
03选择多种文档类型
04查询处理状态并获取结果
05列出文档类型和质量等级

适用场景

01根据视频创建用户指南
02将录制内容整理为 SOP
03根据视频撰写产品文档或博客
04查询文档生成任务状态

MCP 相关

Docsie 向 MCP 客户端提供 `analyze_video`、`check_job_status` 和 `list_doc_types` 工具。它使用 Streamable HTTP，并通过 OAuth2 Authorization Code 与 PKCE 进行认证。

#documentation #productivity #ai #knowledge-base #video #compliance #search #writing

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "docsie-dokuta": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote"
      ],
      "env": {
        "API_KEY": "<API_KEY>"
      }
    }
  }
}

启动命令npx -y mcp-remote

需要配置的环境变量

API_KEY密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmmcp-remotestdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Docsie 视频转文档 MCP 服务

面向 Anthropic 的连接器目录的远程 MCP 服务。使用 Dokuta AI 将视频转换为结构化文档。

功能

Claude 用户可以：

提交视频 URL（YouTube、Loom、Vimeo、直接 MP4 链接等）
选择文档类型（用户指南、SOP、产品文档、政策、博客）
获取结构化的 Markdown 文档

免费层级：免费处理时长不超过 5 分钟的视频。更长的视频需要 Docsie 账户和 AI 积分。

架构

Claude → POST https://mcp.docsie.io/mcp (Bearer token)
              │
              ├─→ Docsie /o2/ (OAuth2 token validation)
              ├─→ Dokuta API (video analysis)
              └─→ Docsie /api/internal/mcp/ (credit deduction)

传输：可流式 HTTP（MCP 规范）
身份验证：通过 Docsie 的 /o2/ 提供方使用 OAuth2 Authorization Code + PKCE
运行时：Python 3.12 + FastMCP + Starlette + uvicorn

MCP 工具

工具	描述
`analyze_video`	提交视频 URL 以生成文档
`check_job_status`	查询进度并获取已完成的结果
`list_doc_types`	列出可用的文档类型和质量等级

本地开发

cd mcp-server

# Install dependencies
pip install -e .

# Configure environment
cp .env.example .env
# Edit .env with your Dokuta API key and Docsie internal URL

# Run
uvicorn app.main:app --reload --port 8000

测试端点

# Health check
curl http://localhost:8000/health

# OAuth metadata
curl http://localhost:8000/.well-known/oauth-authorization-server

# MCP tool listing (via MCP protocol)
curl -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":"1","method":"tools/list","params":{}}'

环境变量

变量	描述	默认值
`MCP_DOCSIE_BASE_URL`	Docsie 公共 URL（用于 OAuth 元数据）	`https://app.docsie.io`
`MCP_DOCSIE_INTERNAL_URL`	Docsie 内部 URL（用于 API 调用）	`http://docsie-web:8080`
`MCP_DOKUTA_API_URL`	Dokuta 视频分析 API	`https://app.videodokuta.com/api/v1`
`MCP_DOKUTA_API_KEY`	Dokuta API 密钥	（必填）
`MCP_MCP_INTERNAL_API_KEY`	Django 内部端点的共享密钥	（必填）
`MCP_OAUTH2_CLIENT_ID`	MCP 应用的 OAuth2 客户端 ID	（必填）
`MCP_FREE_TIER_MAX_SECONDS`	免费视频时长上限，单位为秒	`300`

部署（Kubernetes）

推送到 main 时，GitHub Actions 会自动构建并推送 Docker 镜像。

# Deploy with Helm (secrets managed via Doppler)
helm upgrade --install mcp-staging helm/docsie-mcp/ \
  -n mcp \
  --set image.tag=v2026.04.06.01 \
  --set doppler.token=$DOPPLER_SERVICE_TOKEN

Django 端设置

1. 将内部 API 密钥添加到 Django 设置

在 .env 或环境变量中：

MCP_INTERNAL_API_KEY=your-shared-secret-here

2. 注册 OAuth2 应用

在 Django 管理后台的 /o2/applications/register/ 中：

名称：Claude MCP Connector
客户端类型：Public
授权许可类型：Authorization code
重定向 URI：（Anthropic 在目录注册期间提供）
跳过授权：是

3. 内部端点（已接入）

GET /api/internal/mcp/user-context/ — 令牌验证 + 用户信息
POST /api/internal/mcp/deduct-credits/ — 扣除积分

提交至 Anthropic 连接器目录

要提交到目录，你需要准备：

MCP 服务 URL：https://mcp.docsie.io/mcp
OAuth2 元数据 URL：https://mcp.docsie.io/.well-known/oauth-authorization-server
公司名称：Docsie Inc.
描述："使用 AI 将视频转换为结构化文档。提交视频 URL，即可获取用户指南、SOP、产品文档或博客文章。"
徽标：Docsie 徽标（SVG/PNG）
隐私政策：https://www.docsie.io/privacy-policy/
服务条款：https://www.docsie.io/terms-of-service/