MCP Outline

🚀 MCP 文檔服務器

MCP 文檔服務器實現了模型上下文協議（MCP），搭建起 AI 助手與 Outline 文檔服務交互的橋樑，讓自然語言交互與文檔管理無縫對接。

🚀 快速開始

本項目實現的 MCP 服務器，能讓 AI 助手（如 Claude）與 Outline 文檔管理功能交互，為自然語言交互和 Outline 文檔管理搭建橋樑。

依賴項

• Python 3.10+
• Outline 賬戶及 API 訪問權限
• Outline API Key（從您的 Outline 賬戶設置中獲取）

安裝

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

# 以開發模式安裝
uv pip install -e ".[dev]"

配置

在項目根目錄創建一個 .env 文件，添加以下變量：

# Outline API 配置
OUTLINE_API_KEY=your_outline_api_key_here

# 對於雲端部署的 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 Desktop 中安裝（如果可用）
mcp install src/mcp_outline/server.py --name "文檔大綱助手"

✨ 主要特性

當前已實現的功能如下：

• 文檔搜索：通過關鍵詞搜索文檔
• 集合管理：列出所有可用的集合，並查看文檔結構
• 文檔閱讀：獲取文檔內容，導出為 Markdown 格式
• 評論管理：查看和添加文檔上的評論
• 文檔創建：在指定集合中新建文檔
• 文檔編輯：更新文檔內容並移動文檔
• 反向鏈接管理：查看引用特定文檔的其他文檔

💻 使用示例

基礎用法

搜索文檔

搜索包含“項目計劃”關鍵詞的文檔

列示集合

顯示所有可用的集合

閱讀文檔

獲取 ID 為“docId123”的文檔內容

創建新文檔

在集合“colId456”中創建名為“研究報告”的新文檔，內容如下：
# 引言

這是一個研究報道...

添加評論

向 ID 為“docId123”的文檔添加一條評論：“這份看起來很棒，但我們應在方法論部分添加更多細節。”

移動文檔

將文檔“docId123”移動到集合“colId789”

📚 詳細文檔

貢獻

歡迎貢獻！請隨意提交 Pull Request。

開發

# 運行測試
uv run pytest tests/

# 格式化代碼
uv run ruff format .

📄 許可證

本項目在 MIT 許可證下開源，詳情請查看 LICENSE 文件。

致謝

• 使用 MCP Python SDK 構建
• 採用 Outline API 進行文檔管理