# Notion Prompts MCP Server

这是一个使用 Model Context Protocol (MCP) 标准的服务器，它提供对存储在 Notion 数据库中的提示词的访问。

## 功能特点

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

## 安装

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

# 安装依赖
npm install

# 构建项目
npm run build
```

## 配置

### 1. 创建Notion集成

1. 访问 [Notion Developer Portal](https://www.notion.so/my-integrations)
2. 点击"+ New integration"
3. 填写基本信息
4. 在"Capabilities"部分，确保勾选：Read content
5. 点击"Submit"创建集成
6. 创建后，复制显示的"Internal Integration Token"（以"ntn_"开头），这是您的NOTION_API_KEY

### 2. 创建Notion数据库

1. 在Notion中创建一个新页面
2. 输入 /database 并选择"表格数据库"
3. 设置以下属性：
   - Name（标题属性）：提示词的名称
   - Content（文本属性）：提示词的内容
   - Description（文本属性）：提示词的描述或用途
   - Category（多选属性）：提示词的分类（可选）
4. 在Notion中打开您的提示词数据库
5. 在页面URL中找到数据库ID（`https://www.notion.so/workspace/123456abcdef...`，其中的"123456abcdef..."部分就是数据库ID）
6. 记录这个ID，它将作为NOTION_DATABASE_ID使用
7. 分享数据库给集成（打开提示词数据库、点击右上角的"..."菜单、选择"Add connections"、在搜索框中找到并选择您刚创建的集成）

### 3. 服务器配置

服务器需要以下配置：

- **NOTION_API_KEY**: 你的 Notion API 密钥
- **NOTION_DATABASE_ID**: 存储提示词的 Notion 数据库 ID
- **PROMPT_HANDLING_MODE**: 提示词组合后的处理模式（可选，默认为 process_locally）
  - `return_only`: 仅返回组合后的提示词文本，不做额外处理
  - `process_locally`: 指示客户端使用当前上下文的LLM处理提示词
  - `call_external_api`: 服务器调用外部API处理提示词（需另行配置）

可以通过环境变量或命令行参数提供：

```bash
# 使用环境变量
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
```

## Notion 数据库结构

Notion 数据库应包含以下属性：

- **Name** (标题): 提示词名称
- **Content** (富文本): 提示词内容，可以包含 `{{USER_INPUT}}` 占位符
- **Description** (富文本): 提示词描述
- **Category** (选择): 提示词类别

## 提示词变量

在提示词内容中，你可以使用以下变量：

- `{{USER_INPUT}}`: 将被用户输入替换
- `{{CURRENT_DATE}}`: 当前日期
- `{{CURRENT_TIME}}`: 当前时间
- `{{CURRENT_DATETIME}}`: 当前日期和时间
- `{{PROMPT_NAME}}`: 提示词名称

## MCP 工具

该服务器提供以下 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**: 列出所有可用的提示词类别

## 开发

```bash
# 运行开发版本
npm run dev

# 构建
npm run build

# 运行测试
npm test
```

## 使用示例

```
# 获取特定提示词
请使用get_prompt_by_name工具获取名为"翻译助手"的提示词。

# 组合提示词与用户输入
请使用compose_prompt工具，提示词名称为"翻译助手"，用户输入为"Hello, I am learning to use Cursor with MCP."

# 直接使用提示词处理内容
请使用名为"翻译助手"的提示词翻译以下文本：Hello, I am learning to use Cursor with MCP.

# 刷新缓存
请使用refresh_prompts工具刷新提示词缓存。

# 使用类别调用多个提示词
调用类别为"七把武器"的提示词，分别输出7个svg卡片，输入内容为："只看新闻，不讨论~"。

# 组合处理结果
调用类别为"七把武器"的提示词，先分别输出7个svg卡片，然后将7个svg卡片最终整合到一个html中，输入内容为："只看新闻，不讨论~"。

# AI自主选择
生命，爱与欢笑（奥修）
选择七把武器中一把合适的武器输出
```

## server json 示例
```
{
  "mcpServers": {
    "notion-prompts": {
      "command": "node",
      "args": [
        "D:\\project\\mcp-project\\mcp-server-notion-prompt\\build\\index.js"
      ],
      "env": {
        "NOTION_API_KEY": "ntn_xxx",
        "NOTION_DATABASE_ID": "1ccxxx"
      }
    }
  }
}
```

## 许可证

MIT