OpenParable
Skip to content
← Back to skills

Fns MCP

Apps & Automation
fns-mcp

Fns MCP is an Agent Skill for apps & automation published in the haierkeys/fast-note-sync-service repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Fast Note Sync Service MCP SSE Skill (Bilingual). Allows agents to access and manage notes, files, and vaults via the MCP protocol.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/haierkeys/fast-note-sync-service/blob/HEAD/docs/skills/fns-mcp/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/fns-mcp, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Fast Note Sync (FNS) MCP Skill (Bilingual/双语版)

This skill allows agents to interact with the Fast Note Sync Service using the Model Context Protocol (MCP). 本技能允许 Agent 通过 Model Context Protocol (MCP) 与 Fast Note Sync Service 交互。

Core Capabilities / 核心能力

  • Note Management / 笔记管理: Listing, searching, CRUD, moving, renaming, restoring, and clearing recycle bin. (列表、检索、增删改查、移动、重命名、恢复、清理回收站)
  • Note Enhancement / 笔记增强: Frontmatter patching, appending/prepending, find & replace, and backlinks/outlinks. (Frontmatter 修补、追加/预置、查找替换、双链/外链)
  • File Management / 文件管理: Attachment listing, metadata retrieval, reading content (Base64), renaming, and deletion. (附件列表、元数据、读取内容、重命名、删除)
  • Vault Management / 库管理: Vault listing, creating/updating, and deletion. (库列表、创建/更新、删除)

Configuration Guide / 配置指南

Before using this skill, the agent needs to connect to the MCP SSE interface. 在使用此技能前,Agent 需要连接到 MCP SSE 接口。

Interface Details / 接口信息

  • SSE Endpoint: http://<YOUR_DOMAIN>:9000/api/mcp/sse
  • Message Endpoint: http://<YOUR_DOMAIN>:9000/api/mcp/message
  • Authentication: Requires Authorization: Bearer <YOUR_AUTH_TOKEN> in headers.
  • Client Identity (Optional):
    • X-Client: <ClientType> (e.g., CherryStudio, OpenClaw)
    • X-Client-Name: <ClientName> (e.g., MyAgent)
    • X-Client-Version: <Version>
  • Default Vault (Optional): X-Default-Vault-Name: <VAULT_NAME>

Platform Specific Config / 平台配置示例


Available Tools / 可用工具说明

1. Note Tools / 笔记工具

Tool Name / 工具Description / 描述Arguments / 参数
note_listList notes in a vault / 列出笔记vault, keyword
note_getGet note content / 获取笔记内容vault, path
note_create_or_updateCreate/Update note / 创建或更新笔记vault, path, content
note_deleteDelete note / 删除笔记vault, path
note_renameRename note / 重命名笔记vault, oldPath, newPath
note_restoreRestore note / 恢复笔记vault, path
note_appendAppend content / 追加内容vault, path, content
note_prependPrepend content / 预置内容vault, path, content
note_replaceFind & Replace / 查找替换vault, path, find, replace, regex, all
note_patch_frontmatterPatch Frontmatter / 修补前置参数vault, path, updates (JSON), remove (JSON)
note_get_backlinksGet backlinks / 获取反链vault, path
note_get_outlinksGet outlinks / 获取出链vault, path

2. File Tools / 文件工具

Tool Name / 工具Description / 描述Arguments / 参数
file_listList files / 列出文件vault, keyword
file_get_infoGet metadata / 获取元数据vault, path
file_readRead content (Base64) / 读取内容vault, path
file_deleteDelete file / 删除文件vault, path
file_renameRename file / 重命名文件vault, oldPath, newPath

3. Vault Tools / 库工具

Tool Name / 工具Description / 描述Arguments / 参数
vault_listList vaults / 列出库None
vault_getGet vault details / 获取详情id
vault_create_or_updateCreate/Update vault / 创建或更新vault, id
vault_deleteDelete vault / 删除库id

Best Practices / 最佳实践

  1. Vault Selection: Explicitly specify vault when possible. (尽可能明确指定 vault 参数)
  2. Path Handling: Paths are relative to vault root. (路径相对于库根目录)
  3. Encoding: file_read returns Base64. (文件读取返回 Base64 编码)
  4. Consistency: Be aware of path changes after rename/move. (重命名后注意路径变更)