
PatchX Freenote Agent
io.github.ZsTs119由 GitHub 账号 ZsTs119 发布v0.2.15更新于 Oct 24, 2026
PatchX Freenote MCP: summaries, memories, model results and user-approved webhook workflows.
概览
把 PatchX Freenote 账号接入助手,用于查找已同步的记录、查看已保存的 AI 结果、生成 Markdown 草稿并发送经确认的 webhook。
- 可以做什么
- 查看账号状态、配额、模型用量与已绑定的录音卡
- 按 mobile 或 desktop 平台列出、搜索并读取已同步记录
- 查看 AI 处理记录及其源文本、模型响应、解析结果与最终结果,并可导出到本地文件
- 管理本地 webhook 别名与模板,把记录渲染为 Markdown、保存草稿并发送经确认的消息
- 安装随包提供的 Agent Skill,为兼容的助手补充安装与使用说明
- 适用场景
- 当你的笔记或录音已同步到 PatchX Freenote,并希望助手帮你查找这些记录、查看为其保存的 AI 结果,或把某条记录整理成经审阅的 Markdown 消息发到飞书等团队 webhook 时适用。
- 运行要求
- 本地 npm 启动器需要 Windows、macOS 或 Linux(amd64 或 arm64)上的 Node.js 18+;也可使用支持 Remote MCP 与 OAuth 的平台连接托管端点。需要一个已同步记录的 PatchX Freenote 账号,并通过安装命令在浏览器中登录。安装须在之后启动服务器的同一操作系统/运行环境中执行,且需有可用的系统凭据存储。
安装
在 SourceWeft 中
- 打开 控制台中的 PatchX Freenote Agent,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
PatchX Freenote Agent
PatchX Freenote was formerly called PatchXNote. Existing patchxnote-agent commands, patchxnote-mcp Skill installs, MCP configuration and credentials remain compatible.
[npm version] [GitHub release] [MCP Registry] [skills.sh]
Connect your synced PatchX Freenote records to AI assistants. Find records, review existing AI results, create Markdown drafts, and share approved content through webhooks.
Production service · MCP setup · Download App · User guide (Chinese)
[Connect your PatchX Freenote records to AI assistants]
Quickstart · Connection options · Skill · Usage examples · Troubleshooting · Reference
Published Channels
These links show publication and directory listing. The 0.2.15 verification record documents artifact checks, Windows installation, local protocol discovery, and Registry readback; client/platform acceptance is tracked separately.
Choose Your Connection
Records must already be synced to PatchX Freenote and available to your account. Recorder-card connection, audio processing, and recording remain in the App/PC clients. Read records from the platform you select: mobile or desktop.
Quickstart
[Choose a client, authorize in the browser, and verify the connection]
1. Set up your local client
If your assistant supports Agent Skills, install the Skill first. MCP setup also works without it. Choose one command for the client you use:
Setup checks browser OAuth login and writes or prints the appropriate MCP config. Run it in the same OS/runtime that will launch MCP: Windows desktop apps and WSL/remote sessions use different credential stores. See Client Setup for other clients and manual configuration.
2. Authorize in the browser
Complete the PatchX Freenote sign-in page opened by setup. Keep phone verification codes and credentials on that page. If you need to start browser login explicitly:
3. Verify and use
Refresh or restart your MCP client, let it discover the available tools, then ask: “Find up to five of today's mobile records.” A successful empty result is normal when that account/platform has no matching records. See Verify the Install for additional checks.
Using a hosted platform instead
Create a custom MCP connector named PatchX Freenote MCP, set its server URL to https://freenote.patch-x.cn/mcp, complete the platform's OAuth flow, and refresh its tool list. Follow the platform-specific instructions in client integration notes; support and acceptance vary by platform.
Copy the complete prompt for an AI assistant
Common Workflows
An existing record/result is the input. Local draft files and local webhook aliases require the local tools that provide those capabilities; check the connected endpoint's tool list before using them.
PatchX Freenote MCP Skill
The Skill gives compatible assistants reusable setup, authorization, record lookup, result inspection, and approved webhook instructions. The npm package bundles it, so the recommended install does not require a separate GitHub clone:
This installs the Skill into the user's .agents/skills/patchxnote-mcp directory by default. It does not log in to PatchX Freenote or start an MCP server.
Skill install options and existing-folder handling
Useful skill installer options:
The installer is idempotent. If an existing patchxnote-mcp directory differs and is not managed by this package, it refuses to overwrite it unless --force is supplied. Managed installs include .patchxnote-agent-skill.json with the package version and source hash.
Alternative: install with the skills CLI
For users of the standard skills CLI, this Codex example installs from GitHub into the current project. It installs the Skill, not the MCP connection. Choose either this route or the npm-bundled install above.
Login And MCP Modes
The client transport and the source of its tools are separate:
mcp servespeaks stdio to the local client. In defaultautomode, matching, unexpired browser OAuth credentials select a proxy to the hosted MCP service; otherwise it uses the local implementation.- The local implementation provides 19 tool definitions in
0.2.15. Their data calls still require appropriate authentication. A proxied or directly connected hosted service supplies its own tool set and may differ. - Use the connected endpoint's
tools/listresult as the source of truth for available tools. Local filesystem and webhook capabilities listed below describe the local implementation. mcp loginis the browser OAuth entry. Terminal-onlypatchxnote loginremains the separate legacy Agent login.mcp servedoes not open a login browser when the editor starts.
Client Setup
Supported clients and advanced setup flags
Local setup supports these client IDs:
vscode, cursor, codex, claude-desktop, and windsurf can write a local config file after confirmation. claude-code, trae, qoder, and workbuddy return manual commands or copyable config in V1. Platform clients such as Feishu Aily, Doubao Work Partner, Tencent Agent Development Platform, and enterprise WorkBuddy require the hosted remote MCP gateway and platform-console acceptance instead of local npx.
Useful setup flags:
Run setup in the same OS/runtime that will later launch MCP. For example, a Windows desktop editor needs Windows Credential Manager credentials, while a WSL or remote VS Code session needs credentials in that Linux runtime.
MCP Configuration
Manual stdio configuration and absolute-path fallback
For generic local stdio MCP hosts, use the pure JSON printed by:
The default config looks like this:
Some clients may require a wrapper-specific field such as type: "stdio" or a different top-level key, but the command and args stay the same. If a client rejects npx, kills slow cold starts, or requires allowlisted absolute paths, use the fallback printed by:
The fallback config uses the installed binary path:
MCP Tools
Local implementation: 19 tool definitions
Account And Record Lookup
Webhook Configuration And Sending
AI Result Inspection
Record tools require an explicit platform argument: mobile or desktop. The record list now includes formal saved results plus readable model-generated outputs when the server has model IO data. patchxnote model-io list remains the lower-level AI processing list for finding request IDs and filtering by task or state.
Webhook MCP tools share the same local config, keychain, templates, and sender modules as the CLI. They do not return full webhook URLs or signing secrets, and send calls perform external network requests only when the MCP client explicitly invokes the send tool.
AI result tools are explicit inspection tools. They may expose source text or AI payloads for the logged-in user, so use them only from trusted local MCP hosts. Large fields should be written to an explicit local out file.
CLI Commands
CLI command reference
The examples below are independent commands. Choose the operation for your task; they are not one script to run from top to bottom.
Browser MCP login and local MCP service:
Terminal CLI login:
List AI processing runs and export results:
Get request_id from patchxnote model-io list --platform mobile|desktop when you need a lower-level AI processing run. MCP patchxnote_list_memories returns id and platform for record rendering, drafts, webhook workflows, and model IO field tools; for model-generated entries, that id can be the same value as request_id.
Configure and send webhooks:
Useful global flags:
The npm package is a small installer/launcher wrapper:
Webhook URLs and optional Feishu/DingTalk signing secrets are stored in the local secure credential store, not in the non-secret config file. --url-stdin and --secret-stdin avoid shell history. CLI and MCP webhook sending is manual only, does not follow redirects, and surfaces provider errors directly.
patchxnote model-io export is the preferred complete AI processing export command. patchxnote webhook export-model-io remains available for compatibility.
Verify The Install
These checks do not sign you out or overwrite client configuration:
After authorization, add --verify to mcp status to verify access. If the native binary is on PATH, patchxnote version reports its version and release commit. The current published release is 0.2.15.
Troubleshooting
This applies the registry choice to this command only. If a GitHub download is slow, retry later; the npm-bundled Skill avoids a separate repository clone.
Existing test-environment configuration
Version 0.2.12 and later default to production. Existing explicit --server-base-url flags, PATCHXNOTE_SERVER_BASE_URL / legacy PATCHNOTE_SERVER_BASE_URL environment variables, and server.base_url config values override that default; update or remove test-server overrides in both the terminal and MCP host configuration.
Run mcp login in the same OS/runtime and profile that starts MCP, then check mcp status --verify. OAuth credentials are bound to the server address, so test login does not authenticate production. This update does not migrate test accounts or records. To keep both environments, use separate profiles and an explicit base URL for each.
Sign Out And Undo Setup
Choose the action you need; these are separate maintenance operations:
Security And Risk Notice
- PatchX Freenote server data access is read-only. Agent does not bind hardware, read raw audio, trigger model runs, handle payments, or expose Admin APIs.
- Local webhook configuration and user-approved sending are supported local actions. Sending is explicit, with no automatic background delivery.
- Credentials use OS-native secure storage; MCP config contains no bearer tokens or webhook secrets. Windows, WSL, and remote runtimes do not automatically share credentials.
- Records are scoped to the authenticated account and selected
mobileordesktopplatform. Source text, AI results, exported files, and webhook destinations may be sensitive. - Review content before sharing and use trusted MCP clients. Report vulnerabilities through SECURITY.md, without posting credentials or private records in public issues.
Current Limitations
Search covers record basics cached during the current local MCP session. Linux headless environments need an available secure credential store. Hosted-platform acceptance and local installation are separate; see the client status notes. This is a public beta, without a production SLA.
Release History
Release highlights from 0.2.6 to 0.2.15
0.2.15 Highlights
- Corrects the MCP Registry namespace to preserve GitHub owner casing:
io.github.ZsTs119/patchxnote-agent. - Adds the
mcp servelaunch arguments and validates release metadata before publication. - Keeps the existing runtime behavior and Skill license.
0.2.13 Highlights
- Unifies the English and Chinese setup prompts across README, npm, the bundled Skill, and marketplace copy.
- Explicitly names the production service, Remote MCP endpoint, setup page, and App download URL; existing test-address overrides must be updated when switching.
- Points npm and plugin homepage metadata to the production setup page and retires obsolete domain proposals in current guidance.
0.2.12 Highlights
- Defaults to the production API at
https://freenote.patch-x.cn; hosted MCP useshttps://freenote.patch-x.cn/mcp. - Keeps explicit server flags, environment variables, and config-file overrides available for test environments.
- Documents production re-login and migration of existing test-server configurations.
0.2.11 Highlights
- Bundles the canonical PatchX Freenote MCP Skill inside the npm package.
- Adds
npx -y patchxnote-agent@latest skill installfor npm-based skill installation without relying on a separate skills CLI or GitHub clone. - Makes skill installation idempotent, records a managed marker, and protects manually edited skill folders unless
--forceis explicitly used. - Extends skill package sync and validation so OpenAI, Claude, and npm copies stay byte-identical to
skills/patchxnote-mcp/. - Updates the one-line setup prompt and discovery metadata to prefer the npm-bundled skill installer while preserving MCP setup, browser OAuth, and tool verification.
0.2.10 Highlights
- Adds the reusable PatchX Freenote MCP Skill at
skills/patchxnote-mcp/so compatible AI clients can keep the setup and usage SOP across fresh or long sessions. - Adds OpenAI/Codex, Claude Code, Agent Skills, MCP Registry, Smithery, and third-party directory draft packaging and listing materials.
- Adds MCP Registry metadata through
server.jsonandpackage.json#mcpName, plus local validation and stdio smoke scripts for release evidence. - Updates the one-line setup prompt so agents install the skill when supported, then run MCP setup, browser OAuth, and tool verification without asking users to paste codes or tokens into chat.
0.2.9 Highlights
- Polishes the browser OAuth loopback success and failure pages shown after
patchxnote mcp login. - Keeps the post-login result page focused on plain user guidance, without exposing OAuth codes, state values, or token-shaped details.
- Adds regression coverage for the browser callback pages so future changes keep those sensitive details out of the UI.
0.2.8 Highlights
- Adds
patchxnote setup --client <id>and npm wrapper delegation with dry-run, JSON output, confirmation, config printing, force repair, and local MCP smoke hooks. - Adds a client registry for VS Code, Cursor, Codex, Claude Code, Claude Desktop, Windsurf, Trae, Qoder, WorkBuddy, Feishu/Doubao, Tencent platform, and P1 follow-up clients.
- Adds JSON and TOML config merge adapters with backup, conflict detection, rollback, and manual JSONC mode.
- Adds
patchxnote mcp login/status/logout, browser OAuth with PKCE, MCP OAuth secure storage, and remote/mcpstdio proxy mode with local fallback. - Adds website page specs, detail-page copy, and remote platform gateway design for product-style onboarding.
0.2.6 Highlights
- MCP expands to 19 tools across account/record lookup, webhook delivery, and AI result inspection.
- Webhook workflows are available to MCP: configure named aliases and manually send to Feishu, DingTalk, or generic webhooks.
- AI processing runs can be listed first, then inspected by
request_idfor source text, AI response, parsed result, and final result. - Record lists can now include readable model-generated outputs returned by the server, so users can find a record first and then inspect its source text, AI response, parsed result, or final result.
- Webhook aliases containing dots, Chinese text, or spaces now persist and reload correctly from the local config file.
- README, npm README, and public visual assets have been refreshed for the new user-facing positioning.
Development
For architecture, local development, and checks appropriate to your change, read AGENTS.md, engineering rules, and the release and maintenance runbook. Metadata-only releases use the affected-module validation described in that runbook.
Release Notes For Operators
The runbook covers version synchronization, GitHub Release assets, npm Trusted Publishing, and release verification. Current evidence: 0.2.15.
License
This repository is currently published without an open-source license. Contact PatchX Freenote before redistributing or embedding it in another product.
来源:README.md,提交 7a4f52c
工具
0版本历史
1- v0.2.15最新Sep 16, 2026
评分
已满足适用检查项的 40%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分
请在仓库或注册中心条目中声明许可证。