Changerawr MCP Server

Changerawr MCP サーバー

Changerawr 用の Model Context Protocol（MCP）サーバーです。Claude などの AI アシスタントが、自然言語を使って変更履歴、プロジェクト、コンテンツを管理できます。

機能

🚀 プロジェクト管理

• プロジェクトの一覧表示、作成、更新、削除
• プロジェクト設定（公開設定、自動公開、承認要件）の構成

📝 変更履歴の管理

• 変更履歴エントリーの作成、更新、公開、非公開化
• バージョン管理とタグ付けに対応
• リッチな書式設定が可能な Markdown コンテンツ

🏷️ タグの整理

• エントリーを整理するためのタグの作成と管理
• プロジェクトごとのタグ管理

📊 分析とインサイト

• ダッシュボードの統計情報と分析データを取得
• プロジェクト情報を追跡

🔧 プロジェクト設定

• プロジェクト設定を更新
• デフォルトのタグと公開設定を管理

インストールとセットアップ

前提条件

• Node.js 18 以降がインストールされていること
• Changerawr インスタンスにアクセスできること
• Changerawr の管理者 API キーがあること

1. リポジトリをクローンする

git clone <repository-url>
cd changerawr-mcp-server

2. 依存関係をインストールする

npm install

3. Changerawr API キーを取得する

1. Changerawr 管理パネルにログインします
2. Settings → API Keys に移動します
3. 管理者権限を持つ新しい API キーを作成します
4. キーをコピーします（形式：chr_...）

4. Claude Desktop を設定する

次の設定を Claude Desktop の config.json に追加します。

Windows の場所： %APPDATA%\Claude\config.json macOS の場所： ~/Library/Application Support/Claude/config.json

{
  "mcpServers": {
    "changerawr": {
      "command": "npx",
      "args": ["tsx", "C:\\Users\\username\\WebstormProjects\\changerawr-mcp-server\\src\\index.ts"],
      "env": {
        "CHANGERAWR_API_KEY": "chr_your_api_key_here",
        "CHANGERAWR_BASE_URL": "https://your-changerawr-domain.com",
        "NODE_ENV": "development"
      }
    }
  }
}

重要： パスを実際のプロジェクトの場所に置き換え、環境変数を更新してください。

• CHANGERAWR_API_KEY：Changerawr で取得した実際の API キー
• CHANGERAWR_BASE_URL：Changerawr インスタンスの URL

5. Claude Desktop を再起動する

設定を反映するため、Claude Desktop を完全に終了してから再起動します。

使用例

プロジェクト管理

新しいプロジェクトを作成する：

「自動公開を有効にして公開状態にした『Mobile App』という新しいプロジェクトを作成して」

すべてのプロジェクトを一覧表示する：

「Changerawr にある自分のすべてのプロジェクトを表示して」

プロジェクト設定を更新する：

「Mobile App プロジェクトを非公開にして、すべての変更に承認を必須にして」

変更履歴の管理

変更履歴の下書きエントリーを作成する：

「バージョン 2.1.0 の変更履歴エントリーを作成して。タイトルは『検索機能の強化』で、新しい検索機能の詳細を含めて」

作成してすぐに公開する：

「バグ修正について、バージョン 2.1.1 の変更履歴エントリーを作成して、すぐに公開して」

下書きを公開する：

「未公開の変更履歴エントリーを表示して、セキュリティ強化に関するものを公開して」

既存のエントリーを更新する：

「ID が xyz の変更履歴エントリーを更新して、パフォーマンス改善に関する情報を追加して」

タグ管理

プロジェクトのタグを一覧表示する：

「Mobile App プロジェクトで利用できるタグをすべて表示して」

新しいタグを作成する：

「Mobile App プロジェクト用に『セキュリティ更新』という新しいタグを作成して」

分析

ダッシュボードの統計情報を取得する：

「ダッシュボードの統計情報と最近のアクティビティを表示して」

利用可能なツール

この MCP サーバーは、Changerawr を幅広く管理するための22 個のツールを提供します。

プロジェクトツール（5 個）

• list_projects - すべてのプロジェクトを一覧表示
• get_project - プロジェクトの詳細を取得
• create_project - 新しいプロジェクトを作成
• update_project - プロジェクト設定を更新
• delete_project - プロジェクトを削除（管理者）

変更履歴ツール（8 個）

• list_changelog_entries - フィルタリングして変更履歴エントリーを一覧表示
• get_changelog_entry - 特定のエントリーの詳細を取得
• create_changelog_entry - 新しい下書きエントリーを作成
• update_changelog_entry - 既存のエントリーを更新
• publish_changelog_entry - エントリーを公開して一般に公開
• unpublish_changelog_entry - エントリーを非公開にする
• delete_changelog_entry - エントリーを完全に削除（管理者）
• create_and_publish_changelog_entry - 1 回の操作でエントリーを作成して公開

タグツール（3 個）

• list_tags - プロジェクトのタグを一覧表示
• create_tag - プロジェクト用の新しいタグを作成
• delete_tag - タグを削除（API のサポートは限定的）

設定ツール（2）

• get_project_settings - プロジェクト設定を取得します
• update_project_settings - プロジェクト設定を更新します

分析ツール（1）

• get_dashboard_stats - ダッシュボードの統計情報を取得します

リソース（3）

• changerawr://projects - すべてのプロジェクトの一覧
• changerawr://projects/{projectId}/changelog - プロジェクトの変更履歴エントリー
• changerawr://tags - 利用可能なタグ

ワークフロー

下書き → レビュー → 公開（推奨）

1. 下書きを作成：create_changelog_entry - 未公開のエントリーを作成します
2. 内容をレビュー：内容を編集してレビューします
3. 公開：publish_changelog_entry - ユーザーに表示されるようにします

即時公開

1. 作成して公開：create_and_publish_changelog_entry - 1ステップで実行します

管理者権限

すべての API キーに管理者アクセス権があり、以下が可能です。

• ✅ プロジェクトを即座に作成／削除
• ✅ 即時に公開／非公開に設定
• ✅ エントリーを直接削除
• ✅ プロジェクト設定を完全に管理
• ✅ タグを管理

トラブルシューティング

接続の問題

1. API キーを確認：chr_ で始まり、管理者権限があることを確認します
2. URL を確認：Changerawr インスタンスの URL が正しいことを確認します
3. 接続をテスト：ブラウザーで Changerawr インスタンスにアクセスしてみます

Claude Desktop の問題

1. ログを確認：Windows：%APPDATA%\Claude\logs\
2. 完全に再起動：システムトレイから Claude Desktop を終了します
3. 設定ファイルのパスを確認：config.json 内のファイルパスが正しいことを確認します

ツールの失敗

1. stderr の出力を確認：MCP サーバーには詳細なエラー情報が記録されます
2. プロジェクト ID を確認：正しいプロジェクト ID／エントリー ID を使用していることを確認します
3. API 権限を確認：API キーに管理者アクセス権があることを確認します

開発

開発モードで実行

cd changerawr-mcp-server
npx tsx src/index.ts

ツールのテスト

テストには MCP Inspector を使用します。

npx @modelcontextprotocol/inspector npx tsx src/index.ts

環境変数

変数	必須	説明
CHANGERAWR_API_KEY	✅	Changerawr API キー（chr_ で始まります）
CHANGERAWR_BASE_URL	✅	Changerawr インスタンスの URL
NODE_ENV	❌	詳細なログを記録するには development に設定します

アーキテクチャ

src/
├── index.ts              # Main MCP server entry point
├── client/
│   └── changerawr-client.ts  # API client with Zod validation
├── tools/                # MCP tools for AI interactions
│   ├── index.ts          # Tool registry
│   ├── project-tools.ts  # Project management (5 tools)
│   ├── changelog-tools.ts # Changelog operations (8 tools)
│   ├── tag-tools.ts      # Tag management (3 tools)
│   ├── settings-tools.ts # Project settings (2 tools)
│   └── analytics-tools.ts # Dashboard analytics (1 tool)
├── resources/            # MCP resources for data access
│   ├── index.ts          # Resource registry
│   ├── project-resources.ts
│   └── changelog-resources.ts
└── utils/
    └── validation.ts     # Input validation utilities

セキュリティ

• Changerawr の既存の API キー認証を使用します
• 管理者権限とロールベースのアクセス制御に従います
• すべての操作は Changerawr の監査システムを通じて記録されます
• 安全に操作できるよう、入力検証とエラー処理を行います

ライセンス

MIT ライセンス - 詳細については LICENSE ファイルを参照してください

サポート

問題や質問がある場合：

• 上記のトラブルシューティングのセクションを確認してください
• 詳細なエラー情報については Claude Desktop のログを確認してください
• Changerawr インスタンスにアクセスでき、API キーが有効であることを確認してください