mcp notion

Gagasan MCP Server: notion-texonom

Gagasan berbasis Markdown menavigasi MCP hanya dengan variabel ROOT_PAGE tunggal, menghilangkan kebutuhan untuk token.

• Halaman gagasan dikonversi menjadi catatan mimetype text/markdown .
• Cari dan ambil halaman yang relevan berdasarkan jarak grafik, mempertimbangkan hubungan orangtua-anak dan referensi.

Server Model Context Protocol (MCP) untuk mengelola dan berinteraksi dengan catatan berbasis gagasan. Server berbasis TypeScript ini menunjukkan konsep MCP dengan mengintegrasikan sumber daya, alat, dan diminta untuk berinteraksi dengan halaman gagasan secara efisien.

Fitur

Sumber daya

• Catatan Akses : Daftar dan Ambil Halaman Gagasan Seperti note:// URIS dengan Siput UUID.
• Metadata : Setiap sumber daya mencakup judul, deskripsi, dan konten dalam format Markdown.
• Jenis MIME : Konten dapat diakses dalam format text/markdown .

Peralatan

• Catatan Pencarian : Gunakan alat search_notes untuk mencari halaman gagasan menggunakan string kueri.
  • Input: Teks permintaan untuk memfilter halaman yang relevan.
  • Output: Konten Markdown dari Catatan Pencocokan.

Meminta

• Ringkas Catatan : Hasilkan ringkasan untuk halaman gagasan individu.
  • Prompt yang tersedia:
    • summarize_note : Ringkas catatan khusus oleh URI.
    • suggest_refactor : mengusulkan perbaikan struktural.
    • suggest_fix : Identifikasi perbaikan potensial untuk konten catatan.
    • suggest_enhance : Rekomendasikan peningkatan untuk meningkatkan catatan.
  • Input: Halaman Gagasan URI.
  • Output: Pesan terstruktur untuk ringkasan dan peningkatan.

Perkembangan

Pengaturan

Instal dependensi:

pnpm install

Bangun proyek:

pnpm build

Untuk pengembangan dengan pembuatan ulang Auto:

pnpm watch

Konfigurasi

Untuk mengonfigurasi server dengan gagasan:

• Setel variabel lingkungan:
  • ROOT_PAGE : ID halaman root dari ruang kerja gagasan Anda.

Instalasi untuk Desktop Claude

Untuk menggunakan server ini dengan desktop Claude, tambahkan konfigurasi:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

Contoh konfigurasi:

{
  "mcpServers" : {
    "notion-texonom" : {
      "command" : " node " ,
      "args" : [
        " /path/to/mcp/build/index.js "
      ],
      "env" : {
        "ROOT_PAGE" : " $SOME_UUID "
      }
    }
  }
}

Debugging

Untuk pemecahan masalah dan debugging server MCP, gunakan Inspektur MCP. Untuk memulai inspektur, jalankan:

pnpm inspector

Inspektur menyediakan antarmuka berbasis browser untuk memeriksa komunikasi server berbasis STDIO.

Teknologi Utama

• Integrasi Gagasan: Didukung oleh @texonom/nclient dan @texonom/cli.
• MCP SDK: Implement @modelcontextprotocol/sdk untuk operasi server.