Papernote MCP服务器
日语自述在英语自述后面。
概述
Papernote MCP Server是一个模型上下文协议（MCP）服务器，它使Claude.ai Web能够与基于云的纸币管理系统Papernote进行交互。此服务器通过Claude.ai中的自然语言命令提供创建、读取、更新和管理笔记的工具。
特性
- 创建笔记：使用基于时间戳的自动文件名创建新笔记
- 阅读笔记：按文件名检索笔记内容
- 附加内容：将内容添加到现有笔记的顶部或底部
- 替换文本：在笔记中搜索和替换文本
- 完全更新：完全覆盖笔记内容
- OAuth身份验证：使用客户端ID/密码进行安全访问控制
安装
- 克隆存储库：
git clone https://github.com/daishir0/paper_mcp- 更改到项目目录：
cd paper_mcp- 安装所需的软件包：
pip install -r requirements.txt- 复制
config.yaml.example到config.yaml并配置：
cp config.yaml.example config.yaml- 编辑
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
- 转到Claude.ai 设置>集成
- 点击 添加自定义连接器
- 输入以下内容：
- 统一资源定位符: https://your-domain.com/sse - 客户端ID：您的 oauth.client_id 来自config.yaml - 客户端密钥：您的 oauth.client_secret 来自config.yaml
可用的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后端
- 在生产环境中使用HTTPS和反向代理（Apache/Nginx）
- OAuth凭据保护对MCP服务器的访问
许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。
______________________________________________________________________
Papernote MCP服务器
概要
Papernote MCP Server是Claude.ai Web与Papernote（基于云的笔记本管理系统）合作的Model Context Protocol（MCP）服务器。使用Claude.ai中的自然语言命令，提供创建、读取、更新和管理注释的工具。
机能
- 注释：使用基于时间戳的文件名自动创建新注释
- 注释读取：使用文件名获取注释内容
- 添加内容：在现有注释的顶部或底部添加内容
- 文本替换：查找并替换注释中的文本
- 全体更新：完全覆盖注释内容
- OAuth认证：通过客户端ID/Secret进行安全访问控制
安装方法
- 克隆存储库：
git clone https://github.com/daishir0/paper_mcp- 转到项目目录：
cd paper_mcp- 安装所需的软件包：
pip install -r requirements.txtconfig.yaml.example的config.yaml复制到设置：
cp config.yaml.example config.yamlconfig.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
- Claude.ai的设置>集成移到
- 添加自定义连接器来修改标记元素的显示属性
- 输入：
- 统一资源定位符: 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文件。