Notion Prompts MCP Server

基本能力

产品定位

mcp-server-notion-prompt 是一个用于管理和访问 Notion 数据库中提示词的 MCP 服务器，旨在为开发者提供高效的提示词管理和使用工具。

核心功能

• 提示词资源列表：以 MCP 资源形式提供所有可用提示词
• 提示词读取：通过 ID 或名称读取单个提示词
• 提示词组合：将用户输入与提示词模板组合
• 类别管理：支持按类别分组和查询提示词
• 搜索功能：支持在名称、描述和内容中搜索提示词
• 缓存系统：内置缓存机制，优化性能，减少 API 调用
• 可配置：支持通过环境变量或命令行参数进行配置
• 处理模式：支持多种提示词处理方式，避免LLM越界处理

适用场景

• 内容生成：利用提示词模板快速生成内容
• 开发效率：通过提示词管理和组合提高开发效率
• AI 辅助：在 AI 应用中动态使用提示词

MCP 工具

1. list_prompts: 列出所有可用的提示词
2. get_prompt_by_name: 通过名称获取提示词
3. compose_prompt: 将用户输入整合到提示词模板中
4. process_composed_prompt: 处理组合后的提示词
5. process_category_prompts: 处理指定类别的所有提示词
6. refresh_prompts: 刷新提示词缓存
7. get_prompts_by_category: 获取特定类别的提示词
8. search_prompts: 搜索提示词（名称、描述和内容）
9. list_categories: 列出所有可用的提示词类别

常见问题解答

• 如何配置 Notion 集成？：访问 Notion Developer Portal 创建集成并获取 API 密钥
• 如何创建 Notion 数据库？：在 Notion 中创建表格数据库并设置必要的属性
• 如何启动服务器？：使用 npm start 命令并配置必要的环境变量或命令行参数

使用教程

使用依赖

# 克隆仓库
git clone https://github.com/BaoxingZhang/mcp-server-notion-prompt
cd mcp-server-notion-prompt

# 安装依赖
npm install

# 构建项目
npm run build

安装教程

1. 创建 Notion 集成：访问 Notion Developer Portal 创建集成并获取 API 密钥
2. 创建 Notion 数据库：在 Notion 中创建表格数据库并设置必要的属性
3. 配置服务器：通过环境变量或命令行参数提供必要的配置

# 使用环境变量
export NOTION_API_KEY="your_api_key_here"
export NOTION_DATABASE_ID="your_database_id_here"
export LOG_LEVEL="INFO"  # 可选，默认为 INFO
export CACHE_EXPIRY_TIME="300000"  # 可选，默认为 5 分钟 (300000ms)
export PROMPT_HANDLING_MODE="process_locally"  # 可选，默认为 process_locally

# 启动服务器
npm start

# 或使用命令行参数
npm start -- --notion_api_key=your_api_key_here --notion_database_id=your_database_id_here --prompt_handling_mode=return_only

调试方式

# 运行开发版本
npm run dev

# 运行测试
npm test

许可证

该项目遵循 MIT 开源许可条款。