Server Yuque.git について
Server Yuque.git は、Yuque のアカウント、チーム、ナレッジベース、ドキュメントを管理する MCP サーバーです。MCP クライアントや LLM から Yuque API を使ってコンテンツを検索・管理したいユーザー向けです。
主な機能
- 01Yuque API の接続確認
- 02ドキュメント、ナレッジベース、ユーザー、チームの検索
- 03チームとメンバーの管理
- 04ナレッジベースの作成と管理
- 05ドキュメントの作成、編集、確認
- 06目次とバージョン履歴の管理
活用シーン
- 01Yuque 内のドキュメントやナレッジベースの検索
- 02チームメンバーや役割の変更
- 03ナレッジベースやドキュメントの作成・編集
- 04ドキュメントの版や目次の確認
MCP 対応
Yuque API の操作をツールとして MCP クライアントに公開し、検索のほかユーザー、チーム、ナレッジベース、ドキュメントを管理できます。利用には Yuque API Token が必要です。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Yuque API MCP サーバー
Yuque API 用の MCP(Model Context Protocol)サーバーです。LLM が Yuque API とシームレスにやり取りできるようにします。
機能
このサーバーでは、Yuque API とやり取りするために以下のツールを提供しています。
ユーザー管理
hello- Yuque API への接続が正常に動作しているか確認しますget-current-user- 現在認証されているユーザーの詳細情報を取得します
検索
search- ドキュメント、ナレッジベース、ユーザー、チームを検索します
チーム(グループ)管理
get-user-groups- ユーザーが参加しているチームの一覧を取得しますget-group-users- チームのメンバー一覧を取得しますupdate-group-user- チームメンバーのロールを更新しますdelete-group-user- チームからメンバーを削除しますget-group-stats- チームの統計情報を取得しますget-group-repos- チームが作成したナレッジベースの一覧を取得します
リポジトリ(ナレッジベース)管理
get-user-repos- ユーザーが作成したナレッジベースの一覧を取得しますcreate-repo- 新しいナレッジベースを作成しますupdate-repo- ナレッジベースの情報を更新しますdelete-repo- ナレッジベースを削除しますget-repo-detail- ナレッジベースの詳細情報を取得します
ドキュメント管理
get-book-docs-list- ナレッジベースのドキュメント一覧を取得しますget-book-doc-detail- ナレッジベース内のドキュメントの詳細情報を取得しますcreate-book-doc- ナレッジベースに新しいドキュメントを作成しますupdate-book-doc- ナレッジベース内のドキュメントを更新しますdelete-book-doc- ナレッジベースからドキュメントを削除しますget-group-docs-list- チームのナレッジベースのドキュメント一覧を取得しますget-group-doc-detail- チームのナレッジベース内のドキュメントの詳細情報を取得しますcreate-group-doc- チームのナレッジベースに新しいドキュメントを作成しますupdate-group-doc- チームのナレッジベース内のドキュメントを更新しますdelete-group-doc- チームのナレッジベースからドキュメントを削除しますget-doc-versions- ドキュメントのバージョン履歴を取得しますget-doc-version-detail- ドキュメントのバージョン詳細を取得します
目次(TOC)管理
get-book-toc- ナレッジベースの目次(TOC)を取得しますupdate-book-toc- ナレッジベースの目次(TOC)を更新しますget-group-book-toc- チームのナレッジベースの目次(TOC)を取得しますupdate-group-book-toc- チームのナレッジベースの目次(TOC)を更新します
インストールと使用方法
前提条件
- Node.js 16.x 以降
- Yuque API トークン
インストール
# Install dependencies
pnpm install
# Build the project
pnpm build
設定
Yuque API へのアクセスを認証するため、環境変数 YUQUE_API_TOKEN を設定します。
export YUQUE_API_TOKEN="your-api-token-here"
実行
# Start the server
pnpm start
VS Code での使用
このプロジェクトは、VS Code MCP プラグインによって認識されるように設定されています。VS Code MCP プラグインをインストールしている場合、このサーバーを VS Code で直接使用できます。
- MCP で「server-yuque」を選択します
- Yuque API トークンを入力します
- VS Code で Yuque MCP サーバーの使用を開始します
{
"servers": {
"yuque-api": {
"type": "stdio",
"command": "node",
"args": ["server-yuque"],
"env": {
"YUQUE_API_TOKEN": "YOUR_YUQUE_API_TOKEN"
}
}
}
}
Yuque API トークンの取得方法
- Yuque のウェブサイト(www.yuque.com)にログインします
- 個人設定ページに移動します
- 「Developer Settings」をクリックします
- 新しい API トークンを作成します
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。