systemprompt-mcp-notion

systemprompt-mcp-notion

Website | Documentation

SystemPrompt MCP Notion サーバー

Notion を AI ワークフローにシームレスに統合する、高性能な Model Context Protocol（MCP）サーバーです。このサーバーにより、AI エージェントは標準化されたプロトコルを通じて Notion のページやデータベースを操作できます。このサーバーは MCP Sampling をサポートしており、また必須としています。MCP Sampling は、MCP が Notion ページを作成・更新するために必要です。

互換性のある MCP クライアントはこちらで入手できます。

サーバーの機能

const serverCapabilities: { capabilities: ServerCapabilities } = {
  capabilities: {
    resources: {
      listChanged: true,
    },
    tools: {},
    prompts: {
      listChanged: true,
    },
    sampling: {},
  },
};

主な機能

• 📝 包括的なコンテンツ管理

  • リッチテキスト形式でページを作成・更新
  • Notion ワークスペース全体を検索

• 🛠 開発者にやさしい設計

  • Jest による充実したテストカバレッジ
  • TypeScript サポート
  • 包括的なエラー処理
  • 詳細なログとデバッグツール

前提条件

このサーバーを使用する前に、以下が必要です:

1. Systemprompt API キー（無料）

   • systemprompt.io/console でサインアップしてください
   • ダッシュボードで新しい API キーを作成してください

2. Notion アカウントとワークスペース

   • 有効な Notion アカウント
   • アクセスしたいコンテンツを含むワークスペース

3. Notion インテグレーション

   • notion.so/my-integrations で作成してください
   • 必要な機能:
     • コンテンツの読み取り/更新/挿入
     • データベース管理
     • 検索機能

4. MCP 互換クライアント

   • Systemprompt MCP Client
   • その他の MCP 互換クライアント

クイックスタート

1. インストール

   Smithery 経由でのインストール

   Smithery 経由で Claude Desktop 用に systemprompt-mcp-notion を自動インストールするには:

   npx -y @smithery/cli install systemprompt-mcp-notion --client claude
   

   npm install systemprompt-mcp-notion
   

2. 設定 .env ファイルを作成します:

   SYSTEMPROMPT_API_KEY=your_systemprompt_api_key
   NOTION_API_KEY=your_notion_integration_token
   

3. MCP 設定 MCP 設定 JSON に以下を追加します:

   {
     "mcpServers": {
       "notion": {
         "command": "npx",
         "args": ["systemprompt-mcp-notion"],
         "env": {
           "SYSTEMPROMPT_API_KEY": "your_systemprompt_api_key",
           "NOTION_API_KEY": "your_notion_integration_token"
         }
       }
     }
   }
   

   または、パッケージをローカルにインストールした場合:

   {
     "mcpServers": {
       "notion": {
         "command": "node",
         "args": ["./node_modules/systemprompt-mcp-notion/build/index.js"],
         "env": {
           "SYSTEMPROMPT_API_KEY": "your_systemprompt_api_key",
           "NOTION_API_KEY": "your_notion_integration_token"
         }
       }
     }
   }
   

開発

セットアップ

1. リポジトリをクローンします:

   git clone https://github.com/systemprompt-io/systemprompt-mcp-notion.git
   cd systemprompt-mcp-notion
   

2. 依存関係をインストールします:

   npm install
   

3. 環境を設定します:

   cp .env.example .env
   # Edit .env with your API keys
   

テスト

Jest を使用して高いテストカバレッジを維持しています:

# Run all tests
npm test

# Watch mode for development
npm run test:watch

# Generate coverage report
npm run test:coverage

# Test Notion API connection
npm run test:notion