Notion MCP Server 7hr

🚀 NOTION-MCP-SERVER

このプロジェクトは、Notionと統合するためのMCP（多方協調プロトコル）サーバーです。使いやすく強力なAPIを提供することで、開発者がNotionと連携するアプリケーションを迅速に構築できるよう支援します。

🚀 クイックスタート

5分以内でローカルのMCPサーバーをセットアップしましょう。

git clone https://github.com/your-username/notion-mcp-server.git
cd notion-mcp-server
npm install
npm start

✨ 主な機能

• Notion APIをサポート：MCPプロトコルを通じてNotionプラットフォームと完全に統合します。
• 簡単なデプロイと拡張：最新のアーキテクチャを使用し、サーバーの安定稼働と拡張性を確保します。
• 詳細なドキュメントサポート：包括的なAPIドキュメントと技術ガイドを提供し、開発者がすぐに使い始められるようにします。

📋 必要な権限

プロジェクトを正常に動作させるためには、プロジェクト設定で以下の権限を有効にしてください。

{
  "notion": {
    "read_write": true,
    "discussion_comments": true,
    "database_access": true,
    "user_management": true
  }
}

💻 使用例

基本的な使用法（JavaScript）

const { NotionMCPClient } = require('notion-mcp-client');

async function quickStart() {
    const client = new NotionMCPClient({
        token: 'your_notion_integration_token'
    });

    // 新しいページを作成
    const pageId = await client.pages.create({
        title: 'My New Page',
        content: 'This is a test page created via MCP.'
    });

    console.log('ページID:', pageId);
}

quickStart().catch(console.error);

🤝 コントリビューションガイド

コミュニティからの貢献を歓迎します！問題を見つけた場合は、GitHubで報告してください。機能提案やコードの提出も大歓迎です。

📄 ライセンス

このMCPサーバーはMIT Licenseの下でライセンスされており、著作権表示とライセンス情報を保持する限り、自由に使用、変更、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルを参照してください。

📚 ドキュメント

以下は、Notion MCP Serverの完全なAPIインターフェースのリストです。

1. ページを作成する

• メソッド：POST /api/pages/create
• パラメータ：
  • title: string
  • content: string
• 戻り値：新しく作成されたページのID

2. ページの内容を更新する

• メソッド：PUT /api/pages/{pageId}
• パラメータ：
  • newContent: string
• 戻り値：更新操作の状態

3. ページを削除する

• メソッド：DELETE /api/pages/{pageId}
• パラメータ：なし
• 戻り値：削除操作の状態

4. データベースをクエリする

• メソッド：GET /api/databases/{dbId}/query
• パラメータ：
  • filter: object (オプション)
  • sorts: array (オプション)
• 戻り値：クエリ結果の配列

5. 新しいデータベースを作成する

• メソッド：POST /api/databases
• パラメータ：
  • name: string
  • schema: object
• 戻り値：新しく作成されたデータベースのID

6. ユーザー情報を取得する

• メソッド：GET /api/users/{userId}
• パラメータ：なし
• 戻り値：ユーザーの詳細情報オブジェクト

7. 新しいユーザーを作成する

• メソッド：POST /api/users
• パラメータ：
  • username: string
  • email: string
  • role: string ("user" or "admin")
• 戻り値：新しく作成されたユーザーのID

8. ユーザーのロールを更新する

• メソッド：PUT /api/users/{userId}/role
• パラメータ：
  • newRole: string
• 戻り値：更新操作の状態

9. 現在のユーザーを取得する

• メソッド：GET /api/users/current
• パラメータ：なし
• 戻り値：現在のユーザーのIDとロール情報

10. ファイルのアップロードを処理する

• メソッド：POST /api/files/upload
• パラメータ：
  • file: Fileオブジェクト
  • description: string (オプション)
• 戻り値：アップロードされたファイルのURL

各APIの具体的な使用方法の詳細については、提供されている完全な開発者ドキュメントを参照してください。