Papernote MCP

Papernote MCP服务器

日语自述在英语自述后面。

概述

Papernote MCP Server是一个模型上下文协议（MCP）服务器，它使Claude.ai Web能够与基于云的纸币管理系统Papernote进行交互。此服务器通过Claude.ai中的自然语言命令提供创建、读取、更新和管理笔记的工具。

特性

• 创建笔记：使用基于时间戳的自动文件名创建新笔记
• 阅读笔记：按文件名检索笔记内容
• 附加内容：将内容添加到现有笔记的顶部或底部
• 替换文本：在笔记中搜索和替换文本
• 完全更新：完全覆盖笔记内容
• OAuth身份验证：使用客户端ID/密码进行安全访问控制

安装

1. 克隆存储库：

   git clone https://github.com/daishir0/paper_mcp

1. 更改到项目目录：

   cd paper_mcp

1. 安装所需的软件包：

   pip install -r requirements.txt

1. 复制 config.yaml.example 到 config.yaml 并配置：

   cp config.yaml.example config.yaml

1. 编辑 config.yaml 使用您的设置：

- server.port：服务器端口（默认值：8000） - papernote.api_url：您的Papernote API端点 - papernote.api_key：您的Papernote API密钥 - oauth.client_id：MCP身份验证的OAuth客户端ID - oauth.client_secret：MCP身份验证的OAuth客户端密钥

用法

启动服务器

python main.py

服务器将于启动 http://127.0.0.1:8000 使用SSE传输（端口可在config.yaml中配置）。

生产部署（systemd）

在以下位置创建systemd服务文件 /etc/systemd/system/papermcp.service:

[Unit]
Description=Papernote MCP Server for Claude.ai
After=network.target

[Service]
User=your-user
WorkingDirectory=/path/to/paper_mcp
ExecStart=/bin/bash -c 'source /path/to/python/env && python main.py'
Type=simple
Restart=on-failure

[Install]
WantedBy=multi-user.target

启用并启动：

sudo systemctl daemon-reload
sudo systemctl enable papermcp
sudo systemctl start papermcp

连接到Claude.ai

1. 转到Claude.ai 设置>集成
2. 点击 添加自定义连接器
3. 输入以下内容：

- 统一资源定位符: https://your-domain.com/sse - 客户端ID：您的 oauth.client_id 来自config.yaml - 客户端密钥：您的 oauth.client_secret 来自config.yaml

可用的MCP工具

笔记管理工具

论文管理工具（用于研究）

Claude.ai中的命令示例

连接后，您可以使用自然语言：

注释操作

• “创建关于今天会议的新笔记”
• “显示\[\_\]20250121-123456.txt的内容”
• “将“任务已完成”附加到我的笔记底部”
• 将文档中的“草稿”替换为“最终”
• “搜索有关“会议”的笔记”
• “列出我的所有笔记”
• “显示所有类别”

论文操作（研究）

• “搜索关于‘机器学习’的论文”
• “列出我的所有论文”
• “给我看看这篇论文的细节”
• “X论文的摘要是什么？”
• “比较论文A和B”

备注

• 确保 config.yaml 启动前已正确配置
• 服务器需要运行Papernote API后端
• 在生产环境中使用HTTPS和反向代理（Apache/Nginx）
• OAuth凭据保护对MCP服务器的访问

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

______________________________________________________________________

Papernote MCP服务器

概要

Papernote MCP Server是Claude.ai Web与Papernote（基于云的笔记本管理系统）合作的Model Context Protocol（MCP）服务器。使用Claude.ai中的自然语言命令，提供创建、读取、更新和管理注释的工具。

机能

• 注释：使用基于时间戳的文件名自动创建新注释
• 注释读取：使用文件名获取注释内容
• 添加内容：在现有注释的顶部或底部添加内容
• 文本替换：查找并替换注释中的文本
• 全体更新：完全覆盖注释内容
• OAuth认证：通过客户端ID/Secret进行安全访问控制

安装方法

1. 克隆存储库：

   git clone https://github.com/daishir0/paper_mcp

1. 转到项目目录：

   cd paper_mcp

1. 安装所需的软件包：

   pip install -r requirements.txt

1. config.yaml.example的config.yaml复制到设置：

   cp config.yaml.example config.yaml

1. config.yaml编辑：

- server.port：服务器端口（默认值：8000） - papernote.api_url：Papernote API端点 - papernote.api_key：Papernote API密钥 - oauth.client_id：MCP认证用OAuth Client ID - oauth.client_secret：MCP认证用OAuth Client Secret

用法

启动服务器

python main.py

服务器是http://127.0.0.1:8000中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。

部署到生产环境

/etc/systemd/system/papermcp.service在中创建系统服务文件：

[Unit]
Description=Papernote MCP Server for Claude.ai
After=network.target

[Service]
User=your-user
WorkingDirectory=/path/to/paper_mcp
ExecStart=/bin/bash -c 'source /path/to/python/env && python main.py'
Type=simple
Restart=on-failure

[Install]
WantedBy=multi-user.target

启用和启动：

sudo systemctl daemon-reload
sudo systemctl enable papermcp
sudo systemctl start papermcp

连接到Claude.ai

1. Claude.ai的设置>集成移到
2. 添加自定义连接器来修改标记元素的显示属性
3. 输入：

- 统一资源定位符: https://your-domain.com/sse - 客户端ID：config.yaml的oauth.client_id - 客户端密钥：config.yaml的oauth.client_secret

可用的MCP工具

注释管理工具

工具｜说明｜参数｜ |--------|------|-----------| | create_note 新建注释 content: str | | get_note 用文件名获取注释 filename: str | | append_top ｜标题后添加内容｜ filename, content | | append_bottom 在结尾添加内容 filename, content | | replace_text 查找和替换 filename, search, replace | | update_full 覆盖整个注释 filename, content | | search_notes 查找注释 query, search_type | | list_notes 获取注释列表 category, limit | | list_categories ｜获取类别列表｜-｜ | delete_note 删除注释（自动备份） filename |

论文管理工具（研究用）

工具｜说明｜参数｜ |--------|------|-----------| | search_papers 用标题/注释/摘要搜索论文 query | | list_papers |论文一覧取得| category, limit | | get_paper 获取论文详细信息（包括注释/摘要） pdf_id | | get_paper_summary 只获取论文摘要 pdf_id |

Claude.ai中的使用示例

连接后，您可以使用自然语言：

注释操作

• “请填写今天会议的说明”
• “\[\_\]20250121-123456.txt的内容给我看”
• “在注释末尾添加任务完成”
• “将文档中的‘草稿’替换为‘最终版’”
• “查找会议说明”
• “请给我看一下笔记本一览表”
• 显示类别列表

论文操作（研究）

• “搜索关于机器学习的论文”
• “请给我看一下论文一览表。”
• “让我看看这篇论文的细节。”
• “请告诉我论文X的概要”
• “比较论文A和B”

注意点

• 启动前config.yaml请确保已正确设置
• 服务器需要Papernote API后端
• 在生产环境中，请在反向代理（Apache/Nginx）中使用HTTPS
• Auth凭据保护对MCP服务器的访问

许可证

此项目是在MIT许可证下许可的。有关详细信息，请参见LICENSE文件。