Dollhousemcp

🚀 DollhouseMCP

DollhouseMCPは、統合されたGitHubベースのコレクションを備えた包括的なモデルコンテキストプロトコル（MCP）サーバーです。Claudeやその他の互換性のあるAIアシスタントがさまざまな振る舞いのペルソナをアクティブ化できるようにし、コミュニティ共有と収益化をサポートします。

🚀 クイックスタート

インストール

# グローバルにインストール
npm install -g @mickdarling/dollhousemcp

# Claude Desktopの設定に追加（OSに応じたパスを参照）
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%\Claude\claude_desktop_config.json  
# Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "dollhousemcp": {
      "command": "npx",
      "args": ["@mickdarling/dollhousemcp"]
    }
  }
}

Claude Desktopを再起動すると、DollhouseMCPを使用できるようになります！list_personasを試してみてください。

✨ 主な機能

機能	説明
🎭 23のMCPツール	チャットインターフェースを通じた完全なペルソナのライフサイクル管理
🏪 GitHubコレクション	コミュニティコレクションに対するペルソナの閲覧、検索、インストール、投稿
👤 ユーザーIDシステム	ペルソナ作成者の環境ベースの属性付け
🆔 一意のIDシステム	高度なID生成: what-it-is_YYYYMMDD-HHMMSS_who-made-it
💬 チャットベースの管理	会話型インターフェースを通じたペルソナの作成、編集、検証
🔄 リアルタイム操作	自動バージョンアップと検証を伴うライブ編集
🚀 自動更新システム	バックアップ/ロールバックと依存関係検証を備えたエンタープライズグレードの自動更新
🛡️ データ保護	デフォルトペルソナのコピーオンライト、包括的なバックアップシステム
🏠 ローカルファーストアーキテクチャ	クラウドに依存せずに完全な機能を提供

🔒 エンタープライズグレードのセキュリティ (v1.2.4)

DollhouseMCPは、ペルソナとシステムを保護するための包括的なセキュリティ対策を実装しています。

セキュリティ機能

• 🛡️ コンテンツサニタイズ：DOMPurifyの統合により、ペルソナコンテンツのXSS攻撃を防止
• 📝 YAMLインジェクション防止：スキーマ検証とサイズ制限を備えた安全なパース
• 🔐 トークンセキュリティ：GitHubトークンの検証、保存時の暗号化、ローテーションサポート
• 🐳 コンテナ強化：非ルート実行、読み取り専用ファイルシステム、リソース制限
• 🚦 レート制限：トークンバケットアルゴリズムによりAPIの乱用を防止（デフォルトで1時間あたり10回のチェック）
• ✅ 署名検証：GPG検証によりリリースの信頼性を保証
• 🔍 入力検証：すべてのユーザー入力に対する包括的な検証
• 📊 セキュリティ監視：セキュリティ関連の操作に対する監査ログ

セキュリティテスト

• 487の包括的なテスト：セキュリティ固有のテストスイートを含む
• 継続的なセキュリティスキャン：GitHub Advanced Securityによる
• 脆弱性なし：すべてのセキュリティアラートが解消されています（アクティブなアラートは0件）

📋 前提条件

• Node.js：v20.0.0以上（LTSを推奨）
• npm：v10.0.0以上
• git：リポジトリのクローン用
• オペレーティングシステム：Windows、macOS、またはLinux

⚠️ 重要提示

DollhouseMCPはNode.js 24で開発されていますが、幅広い互換性のためにNode.js 20以上をサポートしています。

🛠️ 利用可能なツール (合計23個)

コアペルソナ管理

• list_personas - 拡張されたメタデータを含むすべてのローカルペルソナを表示
• activate_persona - 名前、ファイル名、または一意のIDでアクティブ化
• get_active_persona - 現在のペルソナ情報を取得
• deactivate_persona - デフォルトモードに戻る
• get_persona_details - 完全なペルソナ詳細を表示
• reload_personas - ファイルシステムからのリフレッシュ

GitHubコレクション統合

• browse_collection - カテゴリ別にペルソナを閲覧
• search_collection - すべてのコレクションペルソナを検索
• get_collection_persona - コレクションペルソナの詳細情報を表示
• install_persona - ワンクリックでのダウンロードとインストール
• submit_persona - GitHubのイシューを通じてコレクションに投稿

ユーザーID管理

• set_user_identity - ペルソナの属性付けのためのユーザー名を設定
• get_user_identity - 現在のIDステータスを表示
• clear_user_identity - 匿名モードに戻る

チャットベースのペルソナ管理

• create_persona - チャットを通じたガイド付きペルソナ作成
• edit_persona - 既存のペルソナフィールドを変更
• validate_persona - 包括的な品質検証

自動更新システム

• check_for_updates - GitHubのリリースを確認して、利用可能なDollhouseMCPの更新をチェック
• update_server - 自動的なgit pull + npm install + ビルドとバックアップの作成
• rollback_update - 自動バックアップから前のバージョンを復元
• get_server_status - バージョン、git情報、およびシステム詳細を含む包括的なサーバーステータス

ペルソナインジケーター

• configure_indicator - AI応答にペルソナインジケーターが表示される方法を設定
• get_indicator_config - 現在のインジケーター設定を表示

💻 使用例

コレクション操作

browse_collection                          # すべてのカテゴリを表示
browse_collection "creative"               # クリエイティブなペルソナを閲覧
search_collection "writing"                # ライティングに関するペルソナを検索
install_persona "creative/storyteller.md"  # コレクションからインストール

ペルソナの作成と管理

create_persona "Study Buddy" "A helpful tutor" "educational" "You are a patient tutor..."
edit_persona "Study Buddy" "description" "An encouraging academic mentor"
validate_persona "Study Buddy"             # 品質と形式をチェック
submit_persona "Study Buddy"               # コミュニティに共有

ユーザーID

set_user_identity "your-username"          # 属性付けのためのユーザー名を設定
get_user_identity                          # 現在のステータスをチェック
clear_user_identity                        # 匿名モードに戻る

自動更新操作

自動更新システムは、安全機能を備えたエンタープライズグレードの更新管理を提供します。

check_for_updates                          # 新しいDollhouseMCPバージョンをチェック
get_server_status                          # 現在のバージョンとシステム情報を表示
update_server true                         # バックアップを作成しながら自動更新を実行
rollback_update true                       # 必要に応じて前のバージョンに戻す

自動更新の仕組み:

1. バージョンチェック: GitHubのリリースAPIをクエリして最新バージョンを確認
2. バックアップ作成: 現在のインストール（ユーザーペルソナを含む）を自動的にバックアップ
3. 更新プロセス:
   • git pullを実行して最新のコードを取得
   • npm installを実行して依存関係を更新
   • npm run buildでTypeScriptを再ビルド
4. 検証: 更新が成功したことを検証
5. ロールバックオプション: 最新の5つのバックアップを保持して簡単に復元できるようにする

安全機能:

• レート制限によりAPIの乱用を防止
• GPG署名検証（利用可能な場合）
• 依存関係のバージョン検証
• 自動バックアップの保持（最新の5つ）
• 更新中にユーザーペルソナが保持される

ペルソナインジケーター

DollhouseMCPは、ペルソナがアクティブなときにAI応答に視覚的なインジケーターを追加します。

[🎭 Creative Writer v2.1 by @mickdarling] Your creative response here...

インジケーターを設定するには：

get_indicator_config                       # 現在の設定を表示
configure_indicator enabled:false          # インジケーターを無効にする
configure_indicator style:"minimal"        # 最小限の形式を使用: 🎭 Creative Writer
configure_indicator style:"compact"        # コンパクトな形式を使用: [Creative Writer v2.1]
configure_indicator style:"full"           # 完全な形式（デフォルト）
configure_indicator emoji:"🤖"             # 絵文字を変更
configure_indicator showAuthor:false       # 作者の属性を非表示にする
configure_indicator bracketStyle:"round"   # [ブラケット]の代わりに(括弧)を使用

永続的な設定のための環境変数：

export DOLLHOUSE_INDICATOR_ENABLED=true
export DOLLHOUSE_INDICATOR_STYLE=minimal
export DOLLHOUSE_INDICATOR_EMOJI=🎨

🖥️ クロスプラットフォームインストール

🐧 Linuxインストール

前提条件

• Node.js: v20.0.0以上
• npm: v10.0.0以上
• git: バージョン管理用

# Ubuntu/Debian
sudo apt update
sudo apt install -y nodejs npm git
# Node.jsのバージョンを確認
node --version  # v20.0.0以上である必要があります

# CentOS/RHEL/Fedora  
sudo dnf install -y nodejs npm git
# Node.jsのバージョンを確認
node --version  # v20.0.0以上である必要があります

# Arch Linux
sudo pacman -S nodejs npm git
# Node.jsのバージョンを確認
node --version  # v20.0.0以上である必要があります

⚠️ 重要提示

システムのNode.jsがv20より古い場合は、NodeSourceからインストールするか、nvmを使用してください。

インストール手順

# リポジトリをクローンしてビルド
git clone https://github.com/DollhouseMCP/mcp-server.git
cd mcp-server
npm install
npm run build

# オプション: ユーザーIDを設定
export DOLLHOUSE_USER="your-username"
export DOLLHOUSE_EMAIL="your-email@example.com"

Claude Desktopの設定 (Linux)

# 設定ファイルの場所
~/.config/Claude/claude_desktop_config.json

# または、XDG_CONFIG_HOMEが設定されている場合は
$XDG_CONFIG_HOME/Claude/claude_desktop_config.json

設定内容:

{
  "mcpServers": {
    "dollhousemcp": {
      "command": "node",
      "args": ["/absolute/path/to/DollhouseMCP/dist/index.js"]
    }
  }
}

🪟 Windowsインストール

前提条件

• Node.js: v20.0.0以上
• npm: v10.0.0以上（Node.jsに含まれています）
• git: バージョン管理用

# https://nodejs.org/ からNode.jsをインストール（LTSバージョンをダウンロード）
# またはChocolateyを使用する場合
choco install nodejs --version=20.18.0
choco install git

# またはwingetを使用する場合
winget install OpenJS.NodeJS Git.Git

# Node.jsのバージョンを確認
node --version  # v20.0.0以上である必要があります

インストール手順 (PowerShell)

# リポジトリをクローンしてビルド
git clone https://github.com/DollhouseMCP/mcp-server.git
cd mcp-server
npm install
npm run build

# オプション: ユーザーIDを設定
$env:DOLLHOUSE_USER = "your-username"
$env:DOLLHOUSE_EMAIL = "your-email@example.com"

Claude Desktopの設定 (Windows)

# 設定ファイルの場所
$env:APPDATA\Claude\claude_desktop_config.json

設定内容（スラッシュまたはダブルバックスラッシュを使用）:

{
  "mcpServers": {
    "dollhousemcp": {
      "command": "node",
      "args": ["C:/path/to/DollhouseMCP/dist/index.js"]
    }
  }
}

🍎 macOSインストール

前提条件

• Node.js: v20.0.0以上
• npm: v10.0.0以上（Node.jsに含まれています）
• git: バージョン管理用

# Homebrewを使用する場合（推奨）
brew install node git

# またはhttps://nodejs.org/ からダウンロードする場合（LTSバージョン）

# Node.jsのバージョンを確認
node --version  # v20.0.0以上である必要があります

インストール手順

# リポジトリをクローンしてビルド
git clone https://github.com/DollhouseMCP/mcp-server.git
cd mcp-server
npm install
npm run build

# オプション: ユーザーIDを設定
export DOLLHOUSE_USER="your-username"
export DOLLHOUSE_EMAIL="your-email@example.com"

Claude Desktopの設定 (macOS)

# 設定ファイルの場所
~/Library/Application Support/Claude/claude_desktop_config.json

設定内容:

{
  "mcpServers": {
    "dollhousemcp": {
      "command": "node",
      "args": ["/absolute/path/to/DollhouseMCP/dist/index.js"]
    }
  }
}

🐳 Dockerインストール

Dockerでのクイックスタート

# リポジトリをクローン
git clone https://github.com/DollhouseMCP/mcp-server.git
cd mcp-server

# Docker Composeでビルドして実行
docker-compose up -d

# または手動でビルド
docker build -t dollhousemcp .
docker run -d --name dollhousemcp dollhousemcp

Docker Compose（推奨）

本番環境デプロイ:

docker-compose up -d

ホットリロードを使用した開発:

docker-compose --profile dev up dollhousemcp-dev

Dockerでのカスタムペルソナ

# カスタムペルソナディレクトリをマウント
docker run -d \
  --name dollhousemcp \
  -v /path/to/your/personas:/app/personas \
  -e DOLLHOUSE_USER="your-username" \
  dollhousemcp

Docker環境変数

# ユーザーIDを設定
DOLLHOUSE_USER=your-username
DOLLHOUSE_EMAIL=your-email@example.com

# カスタムペルソナディレクトリ（コンテナ内）
PERSONAS_DIR=/app/personas

# Node.js環境
NODE_ENV=production

🧪 テスト

テストの実行

このプロジェクトには、クロスプラットフォーム互換性のための包括的なテストが含まれています。

# すべてのテストを実行
npm test

# カバレッジ付きでテストを実行
npm run test:coverage

# 開発用のウォッチモードでテストを実行
npm run test:watch

# 特定のテストスイートを実行
npm run test:auto-update
npm run test:personas
npm run test:collection

テストカバレッジ

現在のテストカバレッジには以下が含まれています:

• ✅ 102の包括的なテスト：すべての機能を網羅
• ✅ 自動更新システム - GitHub API、バックアップ/ロールバック、依存関係検証
• ✅ セキュリティテスト - コマンドインジェクション防止、入力検証
• ✅ クロスプラットフォーム互換性 - Windows、macOS、Linuxのパス処理
• ✅ バージョン検証 - git/npmの出力形式のパーステスト
• ✅ エッジケースカバレッジ - ネットワーク障害、依存関係の欠落、不正な入力

手動検証

設定が正しく機能することを検証します。

# プロジェクトをビルド
npm run build

# サーバーをテスト（サーバー情報が出力されるはず）
node dist/index.js --help 2>/dev/null || echo "Server compiled successfully"

# ペルソナディレクトリを検証
ls -la personas/

# 自動更新システムをテスト
check_for_updates    # Claude Desktopで使用
get_server_status    # 現在のシステムステータスをチェック

☁️ クラウドデプロイメント

コンテナレジストリ

このプロジェクトは以下のコンテナレジストリへのデプロイをサポートしています:

• GitHub Container Registry (ghcr.io)
• Docker Hub
• AWS ECR
• Google Container Registry

クラウドデプロイメントの例

AWS ECS

{
  "family": "dollhousemcp",
  "containerDefinitions": [{
    "name": "dollhousemcp",
    "image": "ghcr.io/mickdarling/dollhousemcp:latest",
    "memory": 512,
    "cpu": 256,
    "environment": [
      {"name": "NODE_ENV", "value": "production"},
      {"name": "PERSONAS_DIR", "value": "/app/personas"},
      {"name": "DOLLHOUSE_USER", "value": "production"}
    ]
  }]
}

Google Cloud Run

gcloud run deploy dollhousemcp \
  --image ghcr.io/mickdarling/dollhousemcp:latest \
  --platform managed \
  --region us-central1 \
  --set-env-vars NODE_ENV=production,DOLLHOUSE_USER=production

Azure Container Instances

az container create \
  --name dollhousemcp \
  --resource-group myResourceGroup \
  --image ghcr.io/mickdarling/dollhousemcp:latest \
  --environment-variables NODE_ENV=production DOLLHOUSE_USER=production

🏗️ プロジェクト構造

DollhouseMCP/
├── .github/
│   ├── actions/
│   │   └── validate-yaml/         # 再利用可能なYAML検証アクション
│   ├── workflows/                 # CI/CDワークフロー
│   └── ISSUE_TEMPLATE/           # バグ/機能/タスクのイシューテンプレート
├── __tests__/
│   ├── unit/                     # コンポーネントの単体テスト
│   ├── integration/              # 統合テスト
│   └── *.test.ts                 # テストファイル（合計372個のテスト）
├── src/
│   ├── index.ts                  # メインのMCPサーバー (DollhouseMCPServer)
│   ├── cache/                    # APIキャッシュレイヤー
│   ├── config/                   # 設定管理
│   ├── marketplace/              # GitHubコレクション統合
│   ├── persona/                  # ペルソナ管理のコア
│   ├── security/                 # 入力検証とセキュリティ
│   ├── server/                   # MCPサーバーのセットアップとツール
│   ├── types/                    # TypeScriptの型定義
│   ├── update/                   # 自動更新システムのコンポーネント
│   └── utils/                    # ユーティリティ関数
├── dist/                         # コンパイルされたJavaScript（自動生成）
├── personas/                     # デフォルトのペルソナコレクション
│   ├── creative-writer.md
│   ├── technical-analyst.md
│   ├── eli5-explainer.md
│   ├── business-consultant.md
│   └── debug-detective.md
├── custom-personas/              # ユーザーが作成したペルソナ（gitで無視されます）
├── docs/                         # ドキュメント
│   ├── auto-update/             # 自動更新システムのドキュメント
│   └── development/             # 開発ノートとガイド
├── scripts/                      # 管理とユーティリティスクリプト
├── Dockerfile                    # マルチステージのDockerビルド
├── docker-compose.yml           # 本番環境と開発環境の設定
├── package.json                 # プロジェクト設定 (dollhousemcp v1.2.1)
├── tsconfig.json                # TypeScriptの設定
├── jest.config.cjs              # Jestのテスト設定
├── setup.sh                     # 自動インストールスクリプト
├── LICENSE                      # AGPL-3.0とプラットフォーム安定性のコミットメント
├── CHANGELOG.md                 # バージョン履歴
├── claude.md                    # Claude用のプロジェクトコンテキスト
└── README.md                    # このファイル

📝 カスタムペルソナの作成

拡張ペルソナ形式

personas/ディレクトリに.mdファイルを作成し、以下の構造に従います。

---
name: "Your Persona Name"
description: "Brief description of what this persona does"
unique_id: "auto-generated-if-missing"
author: "your-username"
triggers: ["keyword1", "keyword2"]
version: "1.0"
category: "creative"
age_rating: "all"
ai_generated: false
generation_method: "human"
price: "free"
license: "CC-BY-SA-4.0"
---

# Your Persona Name

Your persona instructions go here. This content defines how the AI should behave when this persona is activated.

## Response Style
- Communication guidelines
- Tone and approach
- Specific behaviors

## Key Techniques
- Problem-solving methods
- Interaction patterns

メタデータフィールド

必須フィールド

フィールド	説明
name	ペルソナの表示名
description	目的と機能の簡単な説明

オプションフィールド

フィールド	説明
unique_id	自動生成される形式: what-it-is_YYYYMMDD-HHMMSS_who-made-it
author	作成者のユーザー名（DOLLHOUSE_USER環境変数を使用するか、匿名IDを生成）
category	次のいずれか: creative, professional, educational, gaming, personal
triggers	このペルソナを使用するタイミングを示すキーワードの配列
version	セマンティックバージョン番号（編集時に自動インクリメント）
age_rating	コンテンツレーティング: all, 13+, または18+
ai_generated	コンテンツがAIによって作成されたかどうかを示すブールフラグ
price	収益化フィールド - TODO: 将来のリリース（"free"または価格帯をサポートする予定）

📚 組み込みペルソナ

ペルソナ	目的	最適なシチュエーション
Creative Writer	想像力豊かなストーリーテリングとクリエイティブなコンテンツ	ブレインストーミング、クリエイティブライティング、魅力的なナラティブ
Technical Analyst	深い技術分析と体系的な問題解決	アーキテクチャ決定、デバッグ、技術文書
ELI5 Explainer	初心者向けに複雑なトピックを簡単に説明	教育、オンボーディング、概念説明
Business Consultant	戦略的なビジネス分析と提言	戦略計画、ビジネス決定、市場分析
Debug Detective	体系的なデバッグとトラブルシューティング	バグハンティング、システムトラブルシューティング、根本原因分析

🏪 コレクション統合 (ベータ版)

⚠️ 重要: このGitHubベースのコレクションは現在ベータ版です。機能はコミュニティのフィードバックに基づいて変更される可能性があります。

DollhouseMCPには、GitHubベースの実験的なコレクションが含まれています。

• カテゴリ別閲覧: creative, professional, educational, gaming, personal
• コンテンツ検索: キーワードと説明でペルソナを検索
• ワンクリックインストール: コレクションのペルソナをダウンロードして統合
• コミュニティ投稿: submit_personaツールを使用してペルソナを投稿
• バージョン管理: すべてのコレクションコンテンツの完全なGit履歴

⚠️ 重要提示

コレクション機能にはインターネット接続とGitHub APIアクセスが必要です。レート制限が適用される場合があります。

⚠️ 移行ガイド - 破壊的な変更

重要: 最近のバージョンでツール名が変更されました。

• browse_marketplace → browse_collection
• search_marketplace → search_collection
• get_marketplace_persona → get_collection_persona

古いツール名を使用したスクリプトやワークフローがある場合は、新しい名前を使用するように更新してください。

💼 ビジネスモデルと法的事項

ライセンス

• コアサーバー: AGPL-3.0（独自の競合プラットフォームを防止）
• ペルソナコンテンツ: 無料ペルソナにはCC-BY-SA-4.0、有料ペルソナにはカスタムライセンス
• プラットフォーム利用規約: 作成者に優しい80/20の収益分配（収益化が実装された場合、有料ペルソナにのみ適用）

プラットフォームの安定性に関するコミットメント

• 収益化の変更について90日前に通知
• 既存の有料ペルソナに対する12か月の収益分配ロック
• プラットフォームポリシーの更新に対する透明なガバナンス
• 完全なデータポータビリティ権
• ポリシー変更に対するコミュニティのアドバイス入力

🛠️ 開発

利用可能なスクリプト

スクリプト	説明
npm run build	TypeScriptをJavaScriptにコンパイル
npm run start	コンパイルされたサーバーを実行
npm run dev	自動リロードを伴う開発モードで実行
npm run clean	コンパイルされたファイルを削除
npm run rebuild	プロジェクトをクリーンアップして再ビルド
npm run setup	依存関係をインストールしてビルド
npm test	包括的なテストスイートを実行
npm run test:coverage	カバレッジレポート付きでテストを実行

環境変数

これらの環境変数を使用して、サーバーの動作をカスタマイズできます。

# ユーザー属性付け
export DOLLHOUSE_USER="your-username"          # ペルソナ作成のためのユーザー属性付け
export DOLLHOUSE_EMAIL="your-email"            # 連絡先メールアドレス（オプション）

# ディレクトリ構成
export PERSONAS_DIR="/custom/path/to/personas"  # カスタムペルソナディレクトリ

# 自動更新構成
export GITHUB_TOKEN="your-token"               # プライベートリポジトリへのアクセス用（オプション）

# 開発構成
export NODE_ENV="development"                  # 開発モード
export DEBUG="dollhousemcp:*"                  # デバッグログ（オプション）

🔧 トラブルシューティング

一般的な問題

問題	解決策
ペルソナが読み込まれない	personas/ディレクトリが存在し、読み取り権限があることを確認
サーバーが起動しない	npm run rebuildを実行してクリーンアップして再ビルド
コレクションが機能しない	インターネット接続とGitHub APIアクセスを確認
ユーザーIDが保存されない	Claudeを起動する前にDOLLHOUSE_USER環境変数を設定
"Cannot find module"のエラー	npm installが正常に完了したことを確認
TypeScriptのコンパイルエラー	node --versionでNode.jsのバージョンが20以上であることを確認
Claudeにツールが表示されない	設定変更後にClaude Desktopを完全に再起動
デフォルトペルソナが変更された	v1.2.1以降はコピーオンライトを使用しているため、必要に応じてgit restoreを実行
更新/ロールバックの問題	書き込み権限を確認し、DOLLHOUSE_DISABLE_UPDATES=trueで無効にする
レート制限エラー	60秒待機してください。GitHub APIには時間あたりの制限があります。

デバッグ手順

1. ビルドステータスを確認:

   npm run build
   

2. ペルソナファイルを検証:

   ls -la personas/*.md
   

3. サーバーの起動をテスト:

   node dist/index.js
   

4. 設定を検証:

   # Claude Desktopの設定を確認
   cat ~/Library/Application\ Support/Claude/claude_desktop_config.json
   
   # Node.jsのバージョンを確認（20以上が必要）
   node --version
   
   # npmのバージョンを確認
   npm --version
   

5. 自動更新システムをテスト:

   # Claude Desktop内で使用
   check_for_updates    # 利用可能な更新をチェック
   get_server_status    # システム情報を表示
   

6. ペルソナを検証: reload_personasツールを使用して、読み込みエラーをチェック

🤝 コントリビューション

コントリビューションを歓迎します！DollhouseMCPには、Claudeから直接ペルソナを投稿するための統合ツールが含まれています。

統合されたコントリビューションプロセス（推奨）

1. チャットベースのツールを使用して、ペルソナを作成または変更します。

   create_persona "My Awesome Persona" "A helpful assistant for..." "professional"
   

2. ペルソナの品質を確保するために、検証します。

   validate_persona "My Awesome Persona"
   

3. Claudeから直接コレクションに投稿します。

   submit_persona "My Awesome Persona"
   

   これにより、コミュニティレビューのためのGitHubイシューが自動的に作成されます。

手動コントリビューションプロセス

1. リポジトリをフォークします。
2. personas/またはcustom-personas/ディレクトリにペルソナファイルを作成します。
3. メタデータ形式と命名規則に従います。
4. validate_personaツールで十分にテストします。
5. 明確な説明付きでプルリクエストを送信します。

問題の報告

以下を含めてください。

• Node.jsのバージョン (node --version)
• オペレーティングシステムとバージョン
• 完全なエラーメッセージ
• 問題を再現する手順
• 関連するペルソナファイル（適用可能な場合）
• Claude Desktopの設定（機密パスを除く）

開発ガイドライン

1. TypeScriptのベストプラクティスに従います。
2. 既存のコードスタイルとパターンを維持します。
3. 包括的なエラーハンドリングを追加します。
4. 新機能に対してドキュメントを更新します。
5. PRを送信する前に、複数のプラットフォームで十分にテストします。
6. 新機能に対してテストを含めます。
7. リリースに対してセマンティックバージョニングに従います。

開発ワークフロー

# フォークしてクローン
git clone https://github.com/your-username/DollhouseMCP.git
cd mcp-server

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

# 機能ブランチを作成
git checkout -b feature/your-feature-name

# 変更を加えてテスト
npm run build
npm test

# コミットしてプッシュ
git commit -m "feat: your feature description"
git push origin feature/your-feature-name

# プルリクエストを送信

📄 APIリファレンス

MCPツール仕様

各ツールはMCP仕様に従います。

interface DollhouseTool {
  name: string;
  description: string;
  inputSchema: {
    type: "object";
    properties: Record<string, any>;
    required?: string[];
  };
}

ツールカテゴリ

コアペルソナ管理

// list_personas - パラメータなし
// activate_persona - { persona: string }
// get_active_persona - パラメータなし  
// deactivate_persona - パラメータなし
// get_persona_details - { persona: string }
// reload_personas - パラメータなし

コレクション統合

// browse_collection - { category?: string }
// search_collection - { query: string }
// get_collection_persona - { path: string }
// install_persona - { path: string }
// submit_persona - { persona: string }

ユーザーID管理

// set_user_identity - { username: string }
// get_user_identity - パラメータなし
// clear_user_identity - パラメータなし

チャットベースの管理

// create_persona - { name: string, description: string, category?: string, instructions: string }
// edit_persona - { persona: string, field: string, value: string }
// validate_persona - { persona: string }

自動更新システム

// check_for_updates - パラメータなし
// update_server - { confirm: boolean }
// rollback_update - { confirm: boolean }
// get_server_status - パラメータなし

エラーハンドリング

サーバーは、以下の問題に対して詳細なエラーメッセージを提供します。

• 無効なペルソナ識別子 - 有効な名前に関する明確な提案
• ファイルシステムの問題 - パーミッションとパス解決エラー
• 不正なペルソナファイル - YAMLパースと検証エラー
• ネットワークエラー - GitHub APIとコレクションの接続性の問題
• ランタイムエラー - サーバーの起動と操作の失敗

レスポンス形式

すべてのレスポンスは一貫したパターンに従います。

• 成功レスポンス: 要求されたデータと操作ステータスを含む
• エラーレスポンス: エラータイプ、メッセージ、および提案された解決策を含む
• 進捗インジケーター: 長時間の操作に対する段階的なフィードバック
• 検証結果: 推奨事項を含む詳細なレポート

📄 ライセンス

このプロジェクトは、プラットフォームの安定性に関するコミットメントを伴うAGPL-3.0ライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。

プラットフォームの安定性に関する保証:

• ポリシー変更について90日前に通知
• 12か月の収益分配ロック
• 完全なデータポータビリティ権
• コミュニティのアドバイス入力

🏷️ バージョン履歴

v1.2.5 - 2025年7月 (次回のリリース)

コレクションの名前変更と破壊的な変更:

• 🔄 すべての"marketplace"ツールを"collection"に改名:
  • browse_marketplace → browse_collection
  • search_marketplace → search_collection
  • get_marketplace_persona → get_collection_persona
  • install_persona → install_persona (変更なし)
  • submit_persona → submit_persona (変更なし)
• ✅ 後方互換性のエイリアスを追加 (非推奨、v2.0.0で削除されます)
• ✅ リポジトリを/personasから/collectionに更新
• ✅ ユーザーがスクリプトを更新するための移行ガイドを作成
• ✅ すべての日付参照を1月から7月2025年に修正

v1.2.4 - 2025年7月10日 (現在のバージョン)

重要な修正:

• ✅ MCPプロトコルの互換性を修正 - コンソール出力がJSON-RPC通信を中断しないようにしました
• ✅ MCPに安全なロガーユーティリティを追加 - プロトコルセッション中の適切なロギング
• ✅ Claude Desktopでの接続失敗を解消
• ✅ 新しいロギングアプローチでDockerテストを更新
• ✅ 包括的なロガー単体テストを追加

v1.2.3 - 2025年7月10日

バグ修正:

• ✅ 本番環境でのペルソナディレクトリのパス解決を修正
• ✅ process.cwd()から__dirnameベースのパスに変更
• ✅ セットアップスクリプトを修正 - 正しいツール数とリポジトリURLを使用

v1.2.2 - 2025年7月10日

• ✅ 包括的なセキュリティ強化:
  • DOMPurifyによるコンテンツサニタイズ (SEC-001)
  • YAMLインジェクション防止 (SEC-003)
  • GitHubトークンのセキュリティ (SEC-004)
  • Dockerコンテナの強化 (SEC-005)
• ✅ 487の包括的なテスト - 広範なセキュリティカバレッジを含む
• ✅ CIタイミングテストの修正 - 信頼性の高いクロスプラットフォームテスト
• ✅ すべてのテストファイルのTypeScriptコンパイル修正
• ✅ すべてのセキュリティ脆弱性を解消 (アクティブなアラートは0件)

v1.2.1 - 2025年7月8日

• ✅ データ保護に関する重要なバグ修正:
  • デフォルトペルソナのコピーオンライト (Issue #145)
  • ユーザーペルソナをバックアップに含める (Issue #144)
• ✅ npm公開の互換性のためにNode.js 20+が必要
• ✅ 372の包括的なテスト - すべての機能を網羅
• ✅ セキュリティを強化 - すべての脆弱性を解消
• ✅ ドキュメントを改善 - 明確な前提条件を記載

v1.2.0 - 2025年7月7日

• ✅ レート制限の実装 - APIの乱用を防止
• ✅ GPG署名検証 - リリースの信頼性を保証
• ✅ GitHub Advanced Securityの統合
• ✅ 309のテスト - 改善されたCI環境のカバレッジ
• ✅ パッケージの最適化 - 279.3 kB

v1.1.0 - 2025年7月4日

• ✅ プラットフォーム固有のバッジ - Windows、macOS、Linuxの可視性
• ✅ GitHub Project管理 - イシューテンプレートとマイルストーン
• ✅ ARM64 Dockerの修正 - AlpineからDebianベースのイメージに切り替え
• ✅ 100%のワークフロー信頼性 (Docker ARM64を除く)
• ✅ 最初のGitHubリリース - CHANGELOG.md付き
• ✅ リリース時点で合計21個のMCPツール

フェーズ2B+ - 2025年7月3日

• ✅ エンタープライズグレードの自動更新システム - 4つの新しいMCPツール
• ✅ 50の包括的なテスト - すべての機能を網羅
• ✅ セキュリティ強化 - すべてのコマンドインジェクション脆弱性を排除
• ✅ クロスプラットフォームサポート - Windows、macOS、LinuxでのCI/CDテスト
• ✅ Dockerコンテナ化 - 本番環境と開発環境の設定
• ✅ バックアップ/ロールバックと依存関係検証を備えた合計21個のMCPツール

フェーズ2B - 2025年7月1 - 2日

• ✅ 完全なチャットベースのペルソナ管理
• ✅ GitHubマーケットプレイスの統合
• ✅ ユーザーIDと属性付けシステム
• ✅ リアルタイムの検証と編集
• ✅ エンタープライズグレードのGitHub Actionsセキュリティ

フェーズ1 - 2025年7月1日

• ✅ 新しいAGPL-3.0ライセンスのリポジトリ
• ✅ 拡張された一意のIDシステム
• ✅ 匿名ユーザーのサポート
• ✅ マーケットプレイス対応のメタデータスキーマ

---

🎭 ペルソナの力でAIとのやり取りを変革しましょう

サポートが必要な場合は、イシューを作成するか、コレクションをご覧ください。