Instapaper MCP Server

Instapaper MCP服务器

用于Instapaper集成的综合模型上下文协议（MCP）服务器。此服务器允许Claude和其他MCP客户端与您的Instapaper帐户进行交互——阅读、保存、组织和分析您的文章。

就像你看到的？

给我买杯咖啡：https://cmdzed.com/#/portal/support

特性

🛠️ 工具（动作）

内容管理：

• add_bookmark -保存带有标题、描述和文件夹的文章
• add_private_bookmark -保存不带URL的私人内容（电子邮件、笔记、生成的内容）
• delete_bookmark -删除文章
• archive_bookmark -将文章移动到存档
• unarchive_bookmark -从存档还原
• star_bookmark -标记为重要
• unstar_bookmark -删除星号
• move_bookmark -整理到文件夹中
• update_read_progress -跟踪阅读进度

批量操作（并行处理）：

• move_bookmarks_bulk -一次将多个书签移动到一个文件夹
• star_bookmarks_bulk -并行显示多个书签
• unstar_bookmarks_bulk -从多个书签中删除星号
• archive_bookmarks_bulk -一次存档多个书签
• unarchive_bookmarks_bulk -从存档中恢复多个书签
• update_read_progress_bulk -更新多篇文章的阅读进度

文件夹管理：

• list_folders -查看所有文件夹
• create_folder -创建新文件夹
• delete_folder -删除文件夹
• reorder_folders -自定义文件夹顺序

亮点：

• add_highlight -保存重要段落
• list_highlights -查看文章的亮点
• delete_highlight -删除突出显示

搜索与发现：

• list_bookmarks -列出具有同步支持的文件夹中的文章
• search_bookmarks -按标题、URL或描述查找文章

内容访问：

• get_article_content -获取一篇文章的全文
• get_articles_content_bulk -一次从多篇文章中获取内容以进行批量分析

📚 资源（克劳德可以读取的数据）

• instapaper://bookmarks/unread -所有未读文章
• instapaper://bookmarks/archive -存档文章
• instapaper://bookmarks/starred -主演文章
• instapaper://folders -文件夹列表
• instapaper://folder/{folder_id} -特定文件夹中的文章
• instapaper://article/{bookmark_id} -文章全文

💡 提示（可重用工作流）

• weekly_reading_digest -未读文章的有组织摘要
• recommend_next_read -AI驱动的阅读建议
• research_synthesis -综合某一主题文章的见解
• organize_backlog -建议文件夹组织
• archive_candidates -识别要存档的旧文章
• save_as_private_bookmark -保存私人内容和生成见解的指南

安装

先决条件

1. Node.js 18+ 安装在您的系统上
2. Instapaper帐户 具有API证书

步骤1：获取Instapaper API证书

1. 首选https://www.instapaper.com/api
2. 填写API访问请求表
3. 等待批准（通常需要几天时间）
4. 您将收到消费者密钥和消费者密码

步骤2：克隆并安装

# Clone or download this repository
cd instapaper-mcp-server

# Install dependencies
npm install

# Create your environment file
cp .env.example .env

步骤3：配置环境变量

编辑 .env 并添加您的凭据：

INSTAPAPER_CONSUMER_KEY=your_consumer_key_here
INSTAPAPER_CONSUMER_SECRET=your_consumer_secret_here
INSTAPAPER_USERNAME=your_instapaper_email@example.com
INSTAPAPER_PASSWORD=your_instapaper_password

步骤4：构建服务器

npm run build

使用Claude Desktop

配置Claude桌面

将此添加到您的Claude Desktop配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "instapaper": {
      "command": "node",
      "args": ["/absolute/path/to/instapaper-mcp-server/build/index.js"],
      "env": {
        "INSTAPAPER_CONSUMER_KEY": "your_consumer_key",
        "INSTAPAPER_CONSUMER_SECRET": "your_consumer_secret",
        "INSTAPAPER_USERNAME": "your_email",
        "INSTAPAPER_PASSWORD": "your_password"
      }
    }
  }
}

重要提示： 替换 /absolute/path/to/instapaper-mcp-server 与实际的完整路径。

重新启动克劳德桌面

更新配置后，完全重新启动Claude Desktop（退出并重新打开）。

示例用法

配置后，您可以通过Claude与Instapaper进行交互。以下是真实世界的例子，显示了当你发出请求时会发生什么：

示例1：按主题组织最近的书签

你问克劳德：

"Organize my recent bookmarks by topic"

Claude的工作流程：

1. 使用以下命令获取未读书签 list_bookmarks
2. 分析标题和URL以识别主题（例如，“AI/ML”、“设计”、“产品管理”）
3. 使用为每个主题创建新文件夹 create_folder
4. 获取每个类别中文章的书签ID
5. 用途 move_bookmarks_bulk 一次把它们全部组织起来

你看：

✓ Fetched 47 unread bookmarks
✓ Identified topics: AI & Machine Learning (12), UX Design (15), Product Strategy (11), Other (9)
✓ Created folders: "AI & ML", "UX Design", "Product Strategy"
✓ Moved 38 bookmarks to topic folders:
  - AI & ML: 12 moved
  - UX Design: 15 moved  
  - Product Strategy: 11 moved

Your bookmarks are now organized by topic!

示例2：查看热门文章并跨设备同步

你问克劳德：

"Show me my starred articles and mark the most interesting ones as fully read"

Claude的工作流程：

1. 使用以下方式获取带星号的书签 list_bookmarks 和 folder: "starred"
2. 使用以下命令检索带星号项目的全文 get_articles_content_bulk
3. 分析内容并确定最引人注目的文章
4. 使用更新选定文章的阅读进度 update_read_progress_bulk

你看：

✓ Found 24 starred articles
✓ Fetched full text from 24 articles in parallel
✓ Most interesting articles:
  1. "The Future of Design Systems" - Design patterns at scale
  2. "Rethinking Product Strategy" - How great teams think about roadmaps
  3. "AI-Assisted Development" - New tools reshaping engineering

✓ Marked these 3 articles as fully read
✓ Progress updated across your devices

示例3：批处理和归档

你问克劳德：

"Archive all articles older than 3 months that I haven't starred"

Claude的工作流程：

1. 列出所有带有时间戳的未读书签
2. 3个月以上文章的过滤器
3. 不包括任何带星号的
4. 用途 archive_bookmarks_bulk 将它们全部移至存档

你看：

✓ Analyzed 128 bookmarks
✓ Found 47 articles older than 3 months, not starred
✓ Archived 47 bookmarks in parallel:
  - Successfully archived: 47
  - Errors: 0

Your queue is now more focused on recent content!

示例4：研究综合

你问克劳德：

"Find all my articles about remote work culture and create a summary"

Claude的工作流程：

1. 使用搜索书签 search_bookmarks “远程工作文化”
2. 使用以下命令获取整篇文章内容 get_articles_content_bulk
3. 综合所有文章的关键见解
4. 可选择使用星号标记最相关的文章 star_bookmarks_bulk

你看：

✓ Found 8 articles about remote work culture
✓ Retrieved full text from all 8 articles
✓ Analysis: Key themes across your reading:
  - Asynchronous communication is critical (5/8 articles)
  - Building trust in distributed teams (6/8 articles)
  - Time zone management strategies (4/8 articles)

✓ Key takeaways:
  - Documentation and clarity reduce misunderstandings
  - Regular 1-on-1s maintain relationships
  - Async-first mindset improves flexibility

✓ Starred your 3 most-cited articles for reference

示例5：快速内容管道

你问克劳德：

"Save this research summary to Instapaper with the 'AI Research' folder"

Claude的工作流程：

1. 使用保存文章 add_bookmark 到指定文件夹
2. 确认保存已完成

你看：

✓ Saved to Instapaper:
  - Title: "AI Research Summary - Week 48"
  - Folder: AI Research
  - Ready to read on any device

The article will sync to your Kindle in a few minutes.

发展

以开发模式运行

# Watch for changes
npm run watch

# Test with MCP Inspector
npm run inspector

项目结构

instapaper-mcp-server/
├── src/
│   ├── index.ts              # Main MCP server
│   └── instapaper-client.ts  # Instapaper API client
├── build/                     # Compiled JavaScript
├── .env                       # Your credentials (git-ignored)
├── .env.example              # Template
├── package.json
└── tsconfig.json

故障排除

身份验证错误

如果您看到身份验证错误：

1. 在中验证您的凭据 .env
2. 确保您有API访问权限（查看您的Instapaper电子邮件）
3. 尝试通过重新启动Claude Desktop重新进行身份验证

工具未显示

1. 检查路径是否正确 claude_desktop_config.json 是绝对的
2. 验证服务器构建是否成功： npm run build
3. 检查Claude Desktop日志是否有错误

API费率限制

Instapaper有费率限制。如果你打他们：

• 请等待几分钟，然后重试
• 减少请求的频率
• 尽可能使用资源（读取数据）而不是工具

高级功能

阅读全文

"Read the full text of bookmark ID 12345 and summarize it"

克劳德将使用 instapaper://article/{bookmark_id} 访问完整文章内容的资源。

基于文件夹的研究

"Analyze all articles in my 'User Research' folder and identify common themes"

亮点管理

"Add a highlight to bookmark 12345: 'Users prefer familiar patterns over novel ones' at position 1000"

"Show me all my highlights from the article about design systems"

批量操作

批量内容分析：

"Get the content from bookmarks 123, 124, and 125 and identify common themes"

"Fetch all articles in my 'AI Research' folder and analyze them for recent developments"

散装组织：

"Move bookmarks 100, 101, 102, and 103 to my 'UX Research' folder"

"Star all the articles I just found about design systems"

"Archive all bookmarks 200-210"

批量状态更新：

"Mark bookmarks 50, 51, and 52 as fully read (progress 1.0)"

"Unarchive my last 10 archived articles"

所有批量操作并行执行请求以获得最大效率，并返回详细的结果，包括成功计数、失败计数和每个项目的状态。

许可证

麻省理工学院

贡献

欢迎投稿！请随时提交问题或拉取请求。

资源

• Instapaper API文档
• 模型上下文协议规范
• MCP TypeScript SDK

更新日志

v1.2.0（最新）

• 新增5个并行处理的批量操作工具：

- star_bookmarks_bulk -一次标记多个书签 - unstar_bookmarks_bulk -从多个书签中删除星号 - archive_bookmarks_bulk -并行存档多个书签 - unarchive_bookmarks_bulk -从存档中恢复多个书签 - update_read_progress_bulk -更新多篇文章的进度

• 添加 list_bookmarks 具有高级过滤和同步支持的工具
• 添加 reorder_folders 自定义文件夹组织工具
• 通过示例增强批量操作文档
• 所有批量工具都提供详细的成功/失败统计数据

v1.1.0版本

• 添加 get_article_content 获取单个文章文本的工具
• 添加 get_articles_content_bulk 批量文章内容检索工具
• 增强并行处理以获得更好的性能
• 改进了批量操作中的错误处理

v1.0.0

• 初始版本
• 完成Instapaper API的实施
• 所有工具、资源和提示
• OAuth 1.0身份验证
• 全面的错误处理