Sahmadumass Notion MCP Server

🚀 Notion MCP サーバ

Notion MCP（モデルコンテキストプロトコル）サーバは、Notion内のページやデータベースを操作するための主要な機能を提供します。これにより、ユーザーは簡単にコンテンツを管理できます。

✨ 主な機能

• ページ検索：キーワードを使って関連するコンテンツを見つけます。
• ページ内容の取得：指定したページの詳細情報を表示します。
• 新しいページの作成：空白またはテンプレートに基づいた新しいページを作成します。
• ページの編集：既存のページを修正します。
• ページの削除：不要なコンテンツを削除します。
• データベースの管理：カスタムデータベースを操作およびクエリします。

📦 インストール

リポジトリのクローン

以下のコマンドを使用して、プロジェクトリポジトリをクローンします。

git clone https://github.com/yourusername/notion-mcp-server.git

環境依存関係

以下のツールがインストールされていることを確認してください。

• Node.js（推奨バージョン14.0以上）
• npmまたはyarnパッケージマネージャー

依存関係のインストール

プロジェクトディレクトリに移動した後、以下のコマンドを実行します。

npm install

または

yarn install

APIキーの設定

プロジェクトのconfig.jsonファイルに、あなたのNotion APIキーを追加します。

{
  "notion": {
    "apiKey": "your_notion_api_key_here"
  }
}

💻 使用例

新しいページの作成

POST /api/pages
Content-Type: application/json

{
  "title": "新建页面标题",
  "content": "页面内容描述..."
}

データベースのクエリ

GET /api/databases/{databaseId}/query
Query-Param: {
  "filter": {
    "property": "状态",
    "select": {
      "equals": "完成"
    }
  },
  "sort": {
    "property": "创建时间",
    "direction": "ascending"
  }
}

📚 詳細ドキュメント

トラブルシューティング

問題が発生した場合は、以下の内容を確認してください。

• APIキーが正しく設定されており、適切な権限を持っていることを確認します。
• サーバーログを確認します：tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
• すべてのリクエスト形式がNotion API仕様に準拠していることを確認します。

将来の改善計画

• 複雑なクエリ機能のサポート
• コンテンツの書式設定オプションの追加
• より多くのデータブロックタイプのサポート拡張