Notion Prompts MCP Server

Notion Prompts MCP Server

これは、Model Context Protocol（MCP）標準を使用するサーバーで、Notion データベースに保存されたプロンプトにアクセスできます。

機能

• プロンプトリソースの一覧表示：利用可能なすべてのプロンプトを MCP リソースとして提供します
• プロンプトの読み取り：ID または名前で個別のプロンプトを読み取ります
• プロンプトの組み合わせ：ユーザー入力とプロンプトテンプレートを組み合わせます
• カテゴリ管理：プロンプトをカテゴリ別にグループ化して検索できます
• 検索機能：名前、説明、内容からプロンプトを検索できます
• キャッシュシステム：組み込みのキャッシュ機構により、パフォーマンスを最適化し、API 呼び出しを削減します
• 設定可能：環境変数またはコマンドライン引数で設定できます
• 処理モード：LLM が範囲を超えて処理するのを防ぐため、複数のプロンプト処理方法をサポートします

インストール

# 克隆仓库
git clone https://github.com/BaoxingZhang/mcp-server-notion-prompt
cd mcp-server-notion-prompt

# 安装依赖
npm install

# 构建项目
npm run build

設定

1. Notion インテグレーションの作成

1. Notion Developer Portal にアクセスします
2. 「+ New integration」をクリックします
3. 基本情報を入力します
4. 「Capabilities」セクションで、「Read content」にチェックが入っていることを確認します
5. 「Submit」をクリックしてインテグレーションを作成します
6. 作成後、表示された「Internal Integration Token」（「ntn_」で始まる）をコピーします。これが NOTION_API_KEY です

2. Notion データベースの作成

1. Notion で新しいページを作成します
2. /database と入力し、「テーブルデータベース」を選択します
3. 次のプロパティを設定します：
   • Name（タイトルプロパティ）：プロンプトの名前
   • Content（テキストプロパティ）：プロンプトの内容
   • Description（テキストプロパティ）：プロンプトの説明または用途
   • Category（マルチセレクトプロパティ）：プロンプトのカテゴリ（任意）
4. Notion でプロンプトデータベースを開きます
5. ページ URL からデータベース ID を確認します（https://www.notion.so/workspace/123456abcdef... の「123456abcdef...」の部分がデータベース ID です）
6. この ID を記録します。NOTION_DATABASE_ID として使用します
7. インテグレーションにデータベースを共有します（プロンプトデータベースを開き、右上の「...」メニューをクリックし、「Add connections」を選択して、検索ボックスで作成したインテグレーションを見つけて選択します）

3. サーバーの設定

サーバーには次の設定が必要です：

• NOTION_API_KEY：Notion API キー
• NOTION_DATABASE_ID：プロンプトを保存する Notion データベース ID
• PROMPT_HANDLING_MODE：プロンプトを組み合わせた後の処理モード（任意。デフォルトは process_locally です）
  • return_only：組み合わせたプロンプトテキストのみを返し、追加の処理は行いません
  • process_locally：クライアントに、現在のコンテキストの LLM を使用してプロンプトを処理するよう指示します
  • call_external_api：サーバーが外部 API を呼び出してプロンプトを処理します（別途設定が必要です）

環境変数またはコマンドライン引数で指定できます：

# 使用环境变量
export NOTION_API_KEY="your_api_key_here"
export NOTION_DATABASE_ID="your_database_id_here"
export LOG_LEVEL="INFO"  # 可选，默认为 INFO
export CACHE_EXPIRY_TIME="300000"  # 可选，默认为 5 分钟 (300000ms)
export PROMPT_HANDLING_MODE="process_locally"  # 可选，默认为 process_locally

# 启动服务器
npm start

# 或使用命令行参数
npm start -- --notion_api_key=your_api_key_here --notion_database_id=your_database_id_here --prompt_handling_mode=return_only

Notion データベースの構造

Notion データベースには、次のプロパティが必要です：

• Name（タイトル）：プロンプト名
• Content（リッチテキスト）：プロンプトの内容。{{USER_INPUT}} プレースホルダーを含めることができます
• Description（リッチテキスト）：プロンプトの説明
• Category（セレクト）：プロンプトのカテゴリ

プロンプト変数

プロンプトの内容では、次の変数を使用できます：

• {{USER_INPUT}}：ユーザー入力に置き換えられます
• {{CURRENT_DATE}}：現在の日付
• {{CURRENT_TIME}}：現在の時刻
• {{CURRENT_DATETIME}}：現在の日付と時刻
• {{PROMPT_NAME}}：プロンプト名

MCP ツール

このサーバーは、次の MCP ツールを提供します：

1. list_prompts：利用可能なすべてのプロンプトを一覧表示します
2. get_prompt_by_name：名前でプロンプトを取得します
3. compose_prompt：ユーザー入力をプロンプトテンプレートに組み込みます
4. process_composed_prompt：組み合わせたプロンプトを処理します
5. process_category_prompts：指定したカテゴリのすべてのプロンプトを処理します
6. refresh_prompts：プロンプトキャッシュを更新します
7. get_prompts_by_category：特定のカテゴリのプロンプトを取得します
8. search_prompts：プロンプトを検索します（名前、説明、内容）
9. list_categories：利用可能なすべてのプロンプトカテゴリを一覧表示します

開発

# 运行开发版本
npm run dev

# 构建
npm run build

# 运行测试
npm test

使用例

# 获取特定提示词
请使用get_prompt_by_name工具获取名为"翻译助手"的提示词。

# 组合提示词与用户输入
请使用compose_prompt工具，提示词名称为"翻译助手"，用户输入为"Hello, I am learning to use Cursor with MCP."

# 直接使用提示词处理内容
请使用名为"翻译助手"的提示词翻译以下文本：Hello, I am learning to use Cursor with MCP.

# 刷新缓存
请使用refresh_prompts工具刷新提示词缓存。

# 使用类别调用多个提示词
调用类别为"七把武器"的提示词，分别输出7个svg卡片，输入内容为："只看新闻，不讨论~"。

# 组合处理结果
调用类别为"七把武器"的提示词，先分别输出7个svg卡片，然后将7个svg卡片最终整合到一个html中，输入内容为："只看新闻，不讨论~"。

# AI自主选择
生命，爱与欢笑（奥修）
选择七把武器中一把合适的武器输出

サーバー JSON の例

{
  "mcpServers": {
    "notion-prompts": {
      "command": "node",
      "args": [
        "D:\\project\\mcp-project\\mcp-server-notion-prompt\\build\\index.js"
      ],
      "env": {
        "NOTION_API_KEY": "ntn_xxx",
        "NOTION_DATABASE_ID": "1ccxxx"
      }
    }
  }
}

ライセンス

MIT