Noteit MCP

🚀 Noteit MCP

Noteit MCP作為AI提示庫和可視化知識中心，專為開發者打造，是解決AI “Markdown困境” 的良方。它能將冗長的5000字文檔瞬間轉化為易於導航的HTML和邏輯圖，藉助60多種專家角色，讓開發者在組織複雜想法時避免認知過載，真正實現規範驅動開發的可讀性。

🚀 快速開始

連接MCP服務器

MCP服務器地址為 https://www.noteit-mcp.com/api/mcp。以下是不同IDE的連接方式：

Cursor (mcp.json)

創建或更新 ~/.cursor/mcp.json 文件：

{
  "mcpServers": {
    "noteit-mcp": {
      "url": "https://www.noteit-mcp.com/api/mcp"
    }
  }
}

然後重啟Cursor，OAuth認證將自動處理。

Claude Code (內置MCP)

使用命令行助手（全局範圍）：

claude mcp add --transport http noteit-mcp https://www.noteit-mcp.com/api/mcp

或者項目範圍：

claude mcp add -s project --transport http noteit-mcp https://www.noteit-mcp.com/api/mcp

Gemini CLI

添加服務器並進行認證：

gemini mcp add --transport http noteit-mcp https://www.noteit-mcp.com/api/mcp
/mcp auth noteit-mcp
/mcp  # 驗證工具是否列出

其他IDE (API令牌)

在 https://www.noteit-mcp.com 登錄以獲取API令牌。

✨ 主要特性

• 統一配置：可複用的代理配置文件，任何AI客戶端都能採用。
• 高效筆記記錄：AI可讀的筆記、任務和可視化圖表。
• 設計安全：採用OAuth 2.1和透明令牌刷新機制，為非OAuth客戶端提供API令牌。
• 跨IDE兼容：支持Cursor、Claude Code、Gemini CLI、Claude Desktop（通過代理）等多種IDE。

此外，它還擁有60多種適用於不同編碼任務和工作流程的專家角色。

📚 詳細文檔

什麼是Noteit MCP？

Noteit MCP是一個HTTP MCP服務器（Next.js API路由），它允許AI編碼工具安全地訪問兩個核心系統：

• 代理配置文件：可組合的配置（角色、指令、規則、文檔），用於塑造AI在特定任務中的行為。
• 筆記：支持結構化記錄和圖形可視化的個人筆記記錄。

認證方面，對於支持的IDE使用 帶設備指紋的OAuth 2.1，其他MCP客戶端可選擇使用 API令牌 流程。服務器端點為 /api/mcp。

為什麼使用Noteit MCP？

Noteit MCP具有以下優勢：

• 統一配置：可複用的代理配置文件，任何AI客戶端都能採用。
• 高效筆記記錄：AI可讀的筆記、任務和可視化圖表。
• 設計安全：OAuth 2.1 + 透明令牌刷新；為非OAuth客戶端提供API令牌。
• 跨IDE兼容：適用於Cursor、Claude Code、Gemini CLI、Claude Desktop（通過代理）等多種IDE。

可用工具

通過Noteit-MCP，代理可以使用以下工具：

• noteit_profiles_list：列出用戶代理配置文件 - 包含特定角色或任務的角色、指令、規則和文檔的配置集。
• noteit_profiles_getConfig：檢索包含角色、指令、規則和文檔的可組合AI代理配置文件。
• noteit_profiles_generate：生成並保存可組裝成代理配置文件的單個配置組件（角色、規則、文檔、指令）。
• noteit_notes_create：創建4種專業類型的項目筆記：用於常規記錄的 “note”、用於開發任務的 “task”、用於解釋的 “why”、用於問題和錯誤的 “issue”。
• noteit_notes_read：通過唯一ID檢索特定筆記的完整內容。
• noteit_notes_list：瀏覽和過濾所有項目中的用戶筆記，可選擇按標籤、記錄類型或項目名稱進行過濾。
• noteit_web_create：生成交互式HTML筆記，幫助開發者理解複雜概念、流程或技術細節。
• noteit_flow_create：創建支持嵌套數據的可視化流程圖，用於技術流程可視化。

✨ 演示與截圖

🎥 Noteit MCP實際演示 - 完整的使用教程

🎬 點擊觀看完整演示

📊 帶有代理配置文件和筆記管理的統一儀表盤

🤖 40多種適用於不同編碼任務的預建代理模板

📝 帶有圖形可視化的AI可讀筆記

⭐ 給項目點個星

如果Noteit MCP有助於簡化你的AI工作流程，請給它點個星！這有助於他人發現這個工具，並激勵我們持續開發。

📄 許可證

本項目採用MIT許可證。

項目徽章