Syncpen

io.github.airbuzz由 GitHub 账号 airbuzz 发布v1.6.3更新于 Oct 27, 2026

The markdown workspace your AI can read, search, and suggest edits in — every change signed.

概览

AI 生成的概览

将 AI 助手连接到 Syncpen 的 Markdown 工作区,使其能够搜索、阅读、起草、提出修改建议、评论、整理并发布文档。

可以做什么
  • 搜索文档并按 Markdown 读取内容,列出文件夹与文档
  • 创建和更新文档,并以待审建议的形式提出修改,由人工接受或拒绝
  • 读取、回复和解决评论串
  • 创建、重命名、移动和删除文件夹与文档
  • 将文档发布到 WordPress、Ghost 或 Sanity,并列出已连接的 CMS 目标
  • 查看工作区近期变更、相关文档和团队空间
适用场景
适合写作或知识库放在 Syncpen、希望助手起草、交叉链接、评论或发布内容,同时保留人工审批的场景。在研究阶段需要调取已连接的 Drive、Notion、Slack 和新闻来源时也很有用。
运行要求
以 stdio 方式在本机运行,通常通过 npx 启动 syncpen-mcp 包,因此需要 Node.js。需要已开通 API 访问的 Syncpen 账户,并通过环境变量 SYNCPEN_API_KEY 提供 API 密钥。可选的环境变量 SYNCPEN_API_URL 用于指向非生产实例。Drive、Notion、Slack、World News 和 CMS 等集成需先在 Syncpen 账户中连接。
安装前请注意
SYNCPEN_API_KEY 中的密钥可访问你的工作区,且只显示一次,需妥善保管。相关工具可创建、更新、移动和删除文档与文件夹、回复评论并向外部 CMS 发布;删除会进入回收站,但发布和回复对他人可见。来自已连接的 Google Drive、Notion、Slack 和新闻服务的内容会经由 Syncpen API 传输。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Syncpen,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

[Syncpen]

Syncpen MCP Server

Connect Claude Code (or any MCP client) to your Syncpen workspace — the writing workspace your AI can actually write in. Your agent can search, read, draft, suggest, comment, organize, and publish in the same live documents you edit.

Don't have an account yet? Create one free at syncpen.io.

What is Syncpen great at?

  • Build a knowledge base your AI maintains — capture notes, docs, and clips, then let your agent organize, cross-link, and keep it current.
  • Write long-form where you publish — articles, docs, whole books; your agent drafts, you approve, and one call ships it to WordPress, Ghost, or Sanity.
  • Your agents and you on one project — everyone works in the same live documents; every edit is shared, legible, and attributed.
  • Edits with a paper trail — agents propose changes as signed suggestions you accept or reject. Nothing changes silently.
  • Research → draft → ship without leaving your tools — clip sources, let your AI draft from them, publish.

Quick Setup

1. Generate an API Key

  1. Go to Settings → API Keys in your Syncpen account
  2. Enable API Access
  3. Create a new API key
  4. Copy the key (you'll only see it once!)

2. Configure Claude Code

Add to your MCP configuration file (~/.mcp.json or project-level .mcp.json):

json
{  "mcpServers": {    "syncpen": {      "command": "npx",      "args": ["-y", "syncpen-mcp"],      "env": {        "SYNCPEN_API_KEY": "sp_your_api_key_here"      }    }  }}

That's it! Claude Code will automatically download and run the MCP server.

Available Tools

ToolDescription
syncpen_searchSearch documents by title and body content (full text)
syncpen_readRead a document's content as markdown
syncpen_list_foldersList all folders
syncpen_list_documentsList documents, optionally by folder
syncpen_createCreate a new document — personal by default, or in a team space via teamId
syncpen_updateUpdate a document's title and/or content
syncpen_suggest_editPropose an edit as a pending suggestion a human accepts/rejects (doc unchanged until accepted)
syncpen_list_suggestionsList a document's pending (or all) suggestions
syncpen_list_commentsRead comment threads (with replies, line numbers, authors)
syncpen_reply_commentReply to a comment thread (signed, notifies @mentions)
syncpen_resolve_commentMark a comment thread resolved
syncpen_move_documentMove a document into a folder, or to the root
syncpen_delete_documentDelete a document (moved to trash)
syncpen_create_folderCreate a folder (optionally nested)
syncpen_rename_folderRename a folder
syncpen_move_folderMove a folder under a new parent, or to the root
syncpen_delete_folderDelete a folder and its contents (moved to trash)
syncpen_publishPublish a document to WordPress, Ghost, or Sanity
syncpen_list_connectionsList connected CMS targets and their connectionIds — personal by default, or scoped to a team via teamId/documentId
syncpen_list_teamsList your team spaces (id, name, role, member count)
syncpen_recent_changesA time-ordered feed of who created/edited/trashed which documents, and when
syncpen_relatedGiven a document, suggest what else to read — blends co-access (docs worked on together) with the /editor links
syncpen_drive_list_filesList/search files in the user's connected Google Drive
syncpen_drive_read_fileRead a Drive file's content (Google Docs and plain text files only)
syncpen_news_searchSearch recent world news via the user's connected World News API key
syncpen_slack_list_channelsList public channels in the user's connected Slack workspace
syncpen_slack_read_channelRead a public Slack channel's recent message history
syncpen_notion_searchSearch pages in the user's connected Notion workspace
syncpen_notion_read_pageRead a Notion page's top-level content

Usage Examples

Once configured, ask Claude Code:

  • "List my Syncpen folders"
  • "Search for documents that mention authentication"
  • "Read my document titled 'API Design Notes'"
  • "What documents do I have in my 'Projects' folder?"
  • "Publish my 'Launch Post' document to Ghost as a draft"
  • "What's changed in my workspace since yesterday?"

Development

For contributing or running from source:

bash
git clone https://github.com/airbuzz/syncpen-mcp.gitcd syncpen-mcpnpm installnpm run build     # or: npm run dev  (watch mode)

Point your MCP config at the built entry (node /path/to/syncpen-mcp/dist/index.js). It uses the production API by default; set SYNCPEN_API_URL only to target a local instance.

License

MIT

来源:README.md,提交 e7f4bf7

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.6.3最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分