金大哥 - noteit-mcp MCP 详情

article

README

🚀 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许可证。

noteit-mcp