Papernote MCP Server

Papernote MCP Server

日本語のREADMEは、英語のREADMEの後に記載されています。

Overview

Papernote MCP Server is a Model Context Protocol (MCP) server that enables Claude.ai Web to interact with Papernote, a cloud-based note management system. This server provides tools for creating, reading, updating, and managing notes through natural language commands in Claude.ai.

Features

• Create Notes: Create new notes with automatic timestamp-based filenames
• Read Notes: Retrieve note content by filename
• Append Content: Add content to the top or bottom of existing notes
• Replace Text: Search and replace text within notes
• Full Update: Completely overwrite note content
• OAuth Authentication: Secure access control with Client ID/Secret

Installation

1. Clone the repository:

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

2. Change to the project directory:

   cd paper_mcp
   

3. Install the required packages:

   pip install -r requirements.txt
   

4. Copy config.yaml.example to config.yaml and configure:

   cp config.yaml.example config.yaml
   

5. Edit config.yaml with your settings:
   • server.port: Server port (default: 8000)
   • papernote.api_url: Your Papernote API endpoint
   • papernote.api_key: Your Papernote API key
   • oauth.client_id: OAuth Client ID for MCP authentication
   • oauth.client_secret: OAuth Client Secret for MCP authentication

Usage

Starting the Server

python main.py

The server will start on http://127.0.0.1:8000 with SSE transport (port configurable in config.yaml).

Production Deployment (systemd)

Create a systemd service file at /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

Enable and start:

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

Connecting to Claude.ai

1. Go to Claude.ai Settings > Integrations
2. Click Add custom connector
3. Enter the following:
   • URL: https://your-domain.com/sse
   • Client ID: Your oauth.client_id from config.yaml
   • Client Secret: Your oauth.client_secret from config.yaml

Available MCP Tools

Note Management Tools

Paper Management Tools (for Research)

Example Commands in Claude.ai

Once connected, you can use natural language:

Note Operations

• "Create a new note about today's meeting"
• "Show me the content of [_]20250121-123456.txt"
• "Append 'Task completed' to the bottom of my note"
• "Replace 'draft' with 'final' in the document"
• "Search for notes about 'meeting'"
• "List all my notes"
• "Show me all categories"

Paper Operations (Research)

• "Search for papers about 'machine learning'"
• "List all my papers"
• "Show me the details of this paper"
• "What's the summary of paper X?"
• "Compare papers A and B"

Notes

• Ensure config.yaml is properly configured before starting
• The server requires a running Papernote API backend
• Use HTTPS in production with a reverse proxy (Apache/Nginx)
• OAuth credentials protect access to the MCP server

License

This project is licensed under the MIT License - see the LICENSE file for details.

Papernote MCP Server

概要

Papernote MCP Serverは、Claude.ai WebがPapernote（クラウドベースのノート管理システム）と連携するためのModel Context Protocol（MCP）サーバーです。Claude.aiで自然言語のコマンドを使用して、ノートの作成、読み取り、更新、管理を行うためのツールを提供します。

機能

• ノート作成: タイムスタンプベースのファイル名で新規ノートを自動作成
• ノート読み取り: ファイル名でノートの内容を取得
• コンテンツ追加: 既存ノートの上部または下部にコンテンツを追加
• テキスト置換: ノート内のテキストを検索して置換
• 全体更新: ノートの内容を完全に上書き
• OAuth認証: Client ID/Secretによる安全なアクセス制御

インストール方法

1. リポジトリをクローン:

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

2. プロジェ