MCP Outline 服务器

一个模型上下文协议（MCP）服务器，使 AI 助手能够与 Outline（https://www.getoutline.com）的文档服务交互，充当自然语言交互与 Outline 文档管理功能之间的桥梁。

概述

该项目实现了一个模型上下文协议（MCP）服务器，允许 AI 助手（如 Claude）与 Outline 文档服务交互，提供一个连接自然语言交互与 Outline 文档管理能力的桥梁。

特性

目前已实现的功能：

• 文档搜索：通过关键词搜索文档
• 集合管理：列出所有可用的集合，并查看文档结构
• 文档阅读：读取文档内容，导出为 Markdown 格式
• 评论管理：查看和添加文档上的评论
• 文档创建：在指定集合中新建文档
• 文档编辑：更新文档内容并移动文档
• 反向链接管理：查看与特定文档相关的其他文档

入门指南

先决条件

• Python 3.10+ 版本
• Outline 账户及 API 访问权限
• Outline API 密钥（从你的 Outline 账户设置中获取）

安装

# 克隆仓库
git clone https://github.com/Vortiago/mcp-outline.git
cd mcp-outline

# 以开发模式安装
uv pip install -e ".[dev]"

配置

在项目根目录下创建一个 .env 文件，并添加以下变量：

# Outline API 配置
OUTLINE_API_KEY=你的Outline_API_密钥

# 适用于云端部署的 Outline（默认）
# OUTLINE_API_URL=https://app.getoutline.com/api

# 适用于自托管的 Outline
# OUTLINE_API_URL=https://your-outline-instance.example.com/api

运行服务器

# 开发模式与 MCP 监视器一起运行
mcp dev src/mcp_outline/server.py

# 或使用提供的脚本
./start_server.sh

# 在 Claude 桌面版中安装（如果有）
mcp install src/mcp_outline/server.py --name "文档大纲助手"

使用示例

搜索文档

搜索包含“项目规划”的文档

列出集合

显示所有可用的集合

阅读文档

获取 ID 为“docId123”的文档内容

创建新文档

在集合“colId456”中新建一个名为“研究报告”的文档，内容如下：
# 引言

这是研究报告的开头部分...

添加评论

向 ID 为“docId123”的文档添加一条评论：“这份看起来很不错，但我们在方法论部分应该加入更多细节。”

移动文档

将文档“docId123”移动到集合“colId789”

贡献

欢迎贡献！请随时提交 Pull Request。

开发

# 运行测试
uv run pytest tests/

# 格式化代码
uv run ruff format .

许可证

该项目在 MIT 许可证下开源，详情请查看 LICENSE 文件。

致谢

• 使用 MCP Python SDK 构建
• 与 Outline API 结合使用进行文档管理