mcp notion

概念MCP服务器： notion-texonom

基于Markdown的概念仅使用一个ROOT_PAGE变量导航MCP，从而消除了对令牌的需求。

• 概念页面被​​转换为text/markdown mimeType注释。
• 考虑亲子和参考关系，搜索和检索相关页面。

用于管理和与基于概念的注释进行管理和交互的模型上下文协议（MCP）服务器。这款基于打字稿的服务器通过集成资源，工具和提示来有效与概念页面进行交互来演示MCP概念。

特征

资源

• 访问说明：列出和检索概念页面为note://带有uuid slugs的uris。
• 元数据：每个资源都包含标题，描述和内容，以降价格式。
• MIME类型：以text/markdown格式访问内容。

工具

• 搜索说明：使用search_notes工具使用查询字符串搜索概念页面。
  • 输入：查询文本以过滤相关页面。
  • 输出：匹配注释的降价内容。

提示

• 总结说明：生成单个概念页面的摘要。
  • 可用提示：
    • summarize_note ：总结URI的具体说明。
    • suggest_refactor ：提出结构改进。
    • suggest_fix ：确定笔记内容的潜在修复程序。
    • suggest_enhance ：建议增强功能以​​改善注释。
  • 输入：概念页URI。
  • 输出：用于汇总和增强的结构化消息。

发展

设置

安装依赖项：

pnpm install

建立项目：

pnpm build

用于自动建造的开发：

pnpm watch

配置

用概念配置服务器：

• 设置环境变量：
  • ROOT_PAGE ：概念工作区的根页ID。

Claude Desktop的安装

要与Claude Desktop一起使用此服务器，请添加配置：

• macos： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%/Claude/claude_desktop_config.json

示例配置：

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

调试

要进行故障排除和调试MCP服务器，请使用MCP Inspector。要启动检查员，请运行：

pnpm inspector

检查员提供了一个基于浏览器的接口，用于检查基于STDIO的服务器通信。

关键技术

• 概念集成：由@texonom/nclient和@texonom/cli.
• MCP SDK：用于服务器操作的@modelcontextprotocol/sdk 。