Prompt Book Server

Prompt Book Server

AI プロンプトを含む Notion データベースに接続し、複数のプロンプトコレクションにわたってプロンプトを効率的に管理、検索、取得できる MCP サーバーです。

Prompt Book Server でできること

Prompt Book Server は、Notion データベースに保存された AI プロンプトの整理とアクセスに役立つ強力なツールです。主な機能は次のとおりです。

• 複数のプロンプトブック：異なる Notion データベースを使って、複数のプロンプトコレクション（プロンプトブック）を管理します
• プロンプトの検索：タイトル、種類、タグでプロンプトを検索、絞り込み、閲覧します
• プロンプトの取得：任意のプロンプトの全文にすばやくアクセスします
• プロンプトの管理：新しいプロンプトの追加、既存のプロンプトの更新、ブック間でのプロンプトのコピーを行います
• データベースの作成：適切なスキーマを持つ新しいプロンプトデータベースを Notion 内に直接作成します

このサーバーは、AI ツールと Notion ベースのプロンプトコレクションをつなぐ役割を果たします。さまざまなコーディングツールや AI ツールからアクセスできる、プロンプトの一元管理ライブラリを簡単に維持できます。

すべてのツール

設定管理ツール

ツール名	説明
list_prompt_books	設定済みのすべてのプロンプトブックを一覧表示します
create_prompt_book_config	新しいプロンプトブック設定を追加します
remove_prompt_book_config	プロンプトブック設定を削除します
activate_prompt_book	プロンプトブックをアクティブに設定します
rename_prompt_book	プロンプトブック設定の名前を変更します
create_prompt_database	Notion に新しいプロンプトデータベースを作成し、設定に追加します
copy_prompt	あるブックから別のブックにプロンプトをコピーします

プロンプト管理ツール

ツール名	説明
list_prompts	アクティブなデータベース内のすべてのプロンプトを一覧表示します
search_prompts_by_title	タイトルでプロンプトを検索します
get_prompts_by_tag	特定のタグでプロンプトを絞り込みます
get_prompts_by_type	特定の種類でプロンプトを絞り込みます
read_prompt	特定のプロンプトの全文を読み込みます
list_all_types	データベース内の重複しないプロンプトの種類をすべて一覧表示します
list_all_tags	データベース内で使われている重複しないタグをすべて一覧表示します
add_prompt	データベースに新しいプロンプトを追加します
update_prompt	データベース内の既存のプロンプトを更新します

コーディングツール（または非コーディングツール）での設定方法

MCP 設定への追加

サーバーを MCP 設定ファイルに追加します。設定ファイルの場所は MCP クライアントによって異なります。

MCP 設定ファイルのパス

1. cline： ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
2. roo_code： ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
3. windsurf： ~/.codeium/windsurf/mcp_config.json
4. claude： ~/Library/Application Support/Claude/claude_desktop_config.json

次の設定を追加します。

{
  "mcpServers": {
    "prompt-book-server": {
      "command": "npx",
      "args": [
        "-y",
        "@piccollage/prompt-book-mcp-server"
      ],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

使用例のプロンプト

Prompt Book Server とやり取りする際に使えるプロンプトの例を紹介します。

プロンプトの一覧表示と検索

List all my prompt books.

Show me all prompts in the prompt book.

Search for prompts related to "GPUImage" in my prompt book.

Show me all prompts with the tag "PicCollage".

List all prompts of type "Coding"

What types of prompts are available in my prompt book?

プロンプトの読み込み

Get the prompt about idea evaluation from the prompt book.
Follow the instructions in it and then verify the following idea for me:
describe your idea

プロンプトブックの管理

Activate the engineering prompt book.

Copy the GPUImage porting prompt from my private book to the engineering book.

プロンプトの追加と更新

Add a new prompt titled "React Component Generator" with type "Coding" and tags ["React", "Frontend"].

The prompt should include ....
......
.....

Update the "React Component Generator" prompt to include TypeScript support.

Please create a very detailed prompt to instruct LLM agents to convert Android XML UI implementations into Compose UI elements or screens. Put that prompt to the prompt book.

新しいプロンプトブックの追加方法

新しいプロンプトブックを追加する方法は、主に次の 2 つです。

方法 1：既存の Notion データベースに接続する

プロンプトを含む Notion データベースがすでにある場合は、直接接続できます。

1. https://www.notion.so/my-integrations から Notion API トークンを取得します
2. Notion データベースをインテグレーションと共有します
3. URL からデータベース ID を取得します（ワークスペース名の後、疑問符の前の部分です）
4. create_prompt_book_config ツールを使います。

Add a new prompt book with the following details:
- Name: "My Team Prompts"
- Notion token: "secret_abc123..."
- Notion database ID: "1a748be2b63280988d9bc5f89918431d"

オプション 2：新しい Notion データベースを作成する

正しいスキーマで新しいプロンプトデータベースを作成する場合：

1. https://www.notion.so/my-integrations から Notion API トークンを取得します
2. データベースを作成する Notion ページの ID を確認します
3. create_prompt_database ツールを使用します：

Create a new prompt database with these details:
- Name: "My New Prompt Book"
- Notion token: "secret_abc123..."
- Page ID: "1a748be2b63280988d9bc5f89918431d"
- Activate: true

これにより、適切なスキーマ（Name、Type、Tags）を備えた新しいデータベースが作成され、設定に追加されます。

Notion データベースの要件

最適な機能を利用するには、Notion データベースに次のプロパティが必要です：

• Name（タイトル）：プロンプトのタイトル
• Type（選択）：プロンプトのカテゴリ（例：「Coding」、「Image Generation」）
• Tags（複数選択）：プロンプトの整理とフィルタリングに使用するタグ

プロンプトの内容自体は、ページ本文にテキストブロックとして保存されます。

開発

前提条件

• Node.js 16+
• TypeScript
• Notion API トークン

セットアップ

1. リポジトリをクローンします
2. 依存関係をインストールします：npm install
3. プロジェクトをビルドします：npm run build
4. サーバーを実行します：npm start

設定ファイルの構造

~/.mcp_config/prompt_book.json にある設定ファイルは、次の構造です：

{
  "promptBooks": [
    {
      "id": "uuid-string",
      "name": "My Prompt Book",
      "notion_token": "your-notion-api-token",
      "notion_database_id": "your-notion-database-id"
    }
  ],
  "activePromptBookId": "uuid-string"
}

環境変数の設定（DEFAULT_BOOKS）

DEFAULT_BOOKS 環境変数を使用して、デフォルト設定を指定できます。特に次の用途に便利です：

• デプロイ環境でプロンプトブックを自動的に設定する
• チームメンバー向けのデフォルト設定を用意する
• サーバーにプロンプトブックの設定を事前に登録する

DEFAULT_BOOKS 環境変数には、上記の設定ファイル構造に一致する有効な JSON 文字列を指定します。

重要な注意事項：

• DEFAULT_BOOKS 環境変数は、設定ファイル ~/.mcp_config/prompt_book.json がまだ存在しない場合にのみ使用されます
• 設定ファイルがすでに存在する場合、環境変数は無視されます
• DEFAULT_BOOKS の JSON が無効であるか、想定される構造と一致しない場合は無視され、代わりに空の設定が作成されます

使用例：

# Set the environment variable
export DEFAULT_BOOKS='{"promptBooks":[{"id":"12345678-1234-1234-1234-123456789012","name":"Default Prompt Book","notion_token":"secret_abc123...","notion_database_id":"1a748be2b63280988d9bc5f89918431d"}],"activePromptBookId":"12345678-1234-1234-1234-123456789012"}'

# Run the server - it will use the DEFAULT_BOOKS configuration if no config file exists
npx @piccollage/prompt-book-mcp-server

この機能は、コンテナ化された環境でサーバーをデプロイする場合や、チームメンバーに設定済みの環境を提供する場合に特に便利です。