Ones Wiki Mcp Server

ONES Wiki MCP サーバー

ONES Wiki のコンテンツを取得し、AI に適したテキスト形式に変換する Spring AI MCP ベースのサービスです。

特徴

• 🔐 ONES プラットフォームの認証に対応
• 🌐 Wiki URL を API エンドポイントに自動変換
• 📄 Wiki ページのコンテンツを抽出して整形
• 🤖 AI に適したテキスト出力形式
• ⚙️ プロパティファイルまたはコマンドライン引数による設定

前提条件

• Java 17 以降
• Maven 3.6 以降
• ONES プラットフォームのインスタンスにアクセスできること

クイックスタート

1. プロジェクトをビルドする

mvn clean package

2. 認証を設定する

方法 1：application.properties を変更する

src/main/resources/application.properties を編集します。

ones.host=your-ones-host.com
[email protected]
ones.password=your-password

方法 2：コマンドライン引数を使用する

java -jar target/ones-wiki-mcp-server-0.0.1-SNAPSHOT.jar \
  --ones.host=your-ones-host.com \
  [email protected] \
  --ones.password=your-password

方法 3：環境変数を使用する

export ONES_HOST=your-ones-host.com
export [email protected]
export ONES_PASSWORD=your-password
./start-mcp-server.sh

3. MCP クライアントで設定する

Claude Desktop の設定ファイルに追加します。

{
  "mcpServers": {
    "ones-wiki": {
      "command": "java",
      "args": [
        "-jar",
        "/path/to/ones-wiki-mcp-server-0.0.1-SNAPSHOT.jar",
        "--ones.host=your-ones-host.com",
        "[email protected]",
        "--ones.password=your-password"
      ]
    }
  }
}

使用方法

Wiki のコンテンツを取得する

ツールを使用する際は、Wiki ページの完全な URL を指定します。

Please get the content of this Wiki page: https://your-ones-host.com/wiki/#/team/TEAM_UUID/space/SPACE_UUID/page/PAGE_UUID

URL 形式

対応する Wiki URL 形式：

https://{host}/wiki/#/team/{team_uuid}/space/{space_uuid}/page/{page_uuid}

API エンドポイントに自動変換されます。

https://{host}/wiki/api/wiki/team/{team_uuid}/online_page/{page_uuid}/content

出力形式

このサービスは、Wiki ページの HTML コンテンツを構造化された Markdown 形式に変換します。次の内容が含まれます。

• ✅ 見出しレベル（H1～H6）
• ✅ 段落テキスト
• ✅ 順序付きリストと順序なしリスト
• ✅ テーブルデータ（キーと値の形式）
• ✅ 画像の説明
• ✅ リンク情報
• ❌ 取り消し線のコンテンツ（自動的に除外）

技術アーキテクチャ

• Spring Boot 3.4.5 - アプリケーションフレームワーク
• Spring AI MCP - MCP プロトコルのサポート
• Jsoup 1.17.2 - HTML 解析
• RestClient - HTTP クライアント

セキュリティに関する注意事項

• 認証情報は、環境変数または設定ファイルで管理してください。
• HTTPS 接続に対応しています。
• ONES プラットフォームのログイン認証を自動的に処理します。

開発

プロジェクト構成

src/main/java/org/springframework/ai/mcp/sample/server/
├── McpServerApplication.java    # Main application
└── OnesWikiService.java        # ONES Wiki service

テストの実行

mvn test

ソースからビルドする

git clone https://github.com/your-username/ones-wiki-mcp-server.git
cd ones-wiki-mcp-server
mvn clean package

機能の拡張

OnesWikiService に、次のようなツールメソッドを追加できます。

• Wiki ページを検索する
• Wiki のディレクトリ構造を取得する
• 複数のページを一括処理する

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス

Apache License 2.0