noteit-mcp

Noteit MCP

🩹 治愈 AI「Markdown 地狱」——面向开发者的 AI 提示词库 + 可视化知识中心

Noteit-MCP 能将令人头疼的 5,000 字文档即时转化为便于浏览的 HTML 和逻辑图表。借助 60 多个专家角色，无需承受认知负担即可整理复杂想法。让规范驱动开发真正变得易于理解。

✨ 演示与截图

🎥 Noteit MCP 实战演示——完整使用教程

🎬 点击观看完整演示

📊 集成式控制面板，提供 Agent 配置和笔记管理功能

🤖 适用于各种编码任务的 40 多个预构建 Agent 模板

📝 支持 AI 阅读并附带图表可视化的笔记

1) Noteit MCP 是什么？

Noteit MCP 是一个 HTTP MCP 服务（Next.js API 路由），让 AI 编码工具能够安全地访问两个核心系统：

• Agent 配置：可组合的配置（角色、指令、规则、文档），用于塑造 AI 在特定任务中的行为。
• 笔记：个人笔记记录，支持结构化条目和图表可视化。

对于支持设备指纹识别的 IDE，使用 OAuth 2.1 和设备指纹进行身份验证；其他 MCP 客户端也可选择使用 API Token 流程。服务端点位于 /api/mcp。

2) 为什么使用 Noteit MCP？

• 统一配置：可供任何 AI 客户端采用的可复用 Agent 配置。
• 高效记录笔记：AI 可读取的笔记、任务和可视化图表。
• 安全设计：OAuth 2.1 + 透明的令牌刷新；非 OAuth 客户端可使用 API token。
• 支持多种 IDE：Cursor、Claude Code、Gemini CLI、Claude Desktop（通过代理）等。

适用于不同编码任务和工作流的 60 多个专家角色

3) 如何连接

MCP 服务地址为 https://www.noteit-mcp.com/api/mcp。

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  # verify tools are listed

其他 IDE（API Token）

登录 https://www.noteit-mcp.com 获取 API token。

---

4) 可用工具

通过 Noteit-MCP，Agent 可以使用以下工具：

• noteit_profiles_list：列出用户 Agent 配置档案——包含特定角色或任务所需角色设定、指令、规则和文档的配置集
• noteit_profiles_getConfig：获取可组合的 AI Agent 配置档案，其中包含角色设定、指令、规则和文档
• noteit_profiles_generate：生成并保存单个配置组件（角色设定、规则、文档、指令），以便组装成 Agent 配置档案
• noteit_notes_create：创建项目笔记，提供 4 种专用类型：“note”用于一般记录，“task”用于开发任务，“why”用于解释，“issue”用于问题和错误
• noteit_notes_read：通过笔记的唯一 ID 获取指定笔记的完整内容
• noteit_notes_list：浏览和筛选所有用户笔记，可按标签、记录类型或项目名称进行可选筛选
• noteit_web_create：生成交互式 HTML 笔记，帮助开发者理解复杂概念、流程或技术细节
• noteit_flow_create：创建支持嵌套数据的可视化流程图，用于展示技术流程

---

⭐ 为此项目点星

如果 Noteit MCP 有助于简化你的 AI 工作流，请为它点星！这能帮助其他人发现这款工具，并鼓励持续开发。

许可证

MIT