Outline MCP Server

🚀 Outline MCP サーバーの概要

このモデルコンテキストプロトコル（MCP）サーバーは、Outline の API と相互作用するツールを提供し、AI エージェントが Outline の知識ベースプラットフォームを通じて、文書、コレクション、その他のエンティティをプログラムで管理できるようにします。

✨ 主な機能

文書管理

• ✅ カスタム属性を持つ新しい文書を作成
• ✅ 文書の詳細情報を取得
• ✅ 既存の文書を更新
• ✅ 文書を削除
• ✅ 文書を一覧表示
• ✅ 文書を検索
• ✅ 文書に自然言語で質問する
• ✅ 既存の文書からテンプレートを作成
• ✅ 文書を別のコレクションまたは場所に移動
• ✅ 文書をアーカイブ

コレクション管理

• ✅ コレクションの詳細情報を取得
• ✅ コレクションを一覧表示
• ✅ コレクションを作成および更新

コメント管理

• ✅ 文書にコメントを作成
• ✅ 既存のコメントを更新
• ✅ コメントを削除

ユーザー管理

• ✅ ユーザーを一覧表示し、フィルタリングする

⚠️ 重要提示

SSE サーバーの実装には Supergateway を使用しており、Cursor の MCP との統合時により信頼性の高い接続を提供します。

🚀 クイックスタート

前提条件

• Node.js (v18 以上)
• API アクセス権を持つ Outline アカウント
• 適切な権限を持つ Outline API キー

📦 インストール

# 直接 npx で実行
OUTLINE_API_KEY=… npx outline-mcp-server

# または npm からインストール
npm install -g outline-mcp-server
OUTLINE_API_KEY=… outline-mcp-server

# カスタムポートで実行（デフォルトは 6060）
OUTLINE_API_KEY=… outline-mcp-server --port 7070

環境変数

• OUTLINE_API_KEY (必須): あなたの Outline API キー
• OUTLINE_API_URL (オプション): 代替ドメインまたは自前でホストした Outline API の代替 URL

CLI オプション

• --port <number> (オプション): サーバーが実行されるポートを指定（デフォルト: 6060）

使用方法

インストールが完了したら、モデルコンテキストプロトコルをサポートする AI アシスタント（例: Cursor の Claude）を使用して、MCP サーバーとやり取りできます。

AI アシスタントが処理できるサンプルクエリ:

• “すべての Outline ワークスペース内の文書を一覧表示”
• “‘製品’コレクションに新しい文書を作成”
• “特定のトピックに関連するすべての文書を検索”
• “文書に自然言語で質問する”
• “既存の文書からテンプレートを作成”
• “文書の内容を更新”
• “文書にコメントを追加”

🔧 開発

# このリポジトリをクローン
git clone https://github.com/mmmeff/outline-mcp.git
cd outline-mcp

# 依存関係をインストール
npm install

あなたの Outline API キーを含む .env ファイルを作成:

OUTLINE_API_KEY=your_outline_api_key_here
OUTLINE_API_URL=https://your-outline-instance.com/api  # オプション、デフォルトは https://app.getoutline.com/api

# プロジェクトをビルド/監視しながら @modelcontextprotocol/mcp-ai を実行
npm run dev

🤝 コントリビューション

コントリビューションを歓迎します！詳細は CONTRIBUTING.md を参照してください。

📄 ライセンス

MIT License

📞 連絡先

• 作者: mmmeff
• リポジトリ: GitHub 上の outline-mcp