mcpField
F
Flomo Mcp

Flomo Mcp

本地服务
github.com/hutusi生产力063 周前更新
代码仓库

关于 Flomo Mcp

Flomo Mcp 是用于记录和管理纯文本笔记的 TypeScript MCP 服务，提供笔记资源、创建工具，以及将笔记内容用于摘要的提示词。

主要功能

  1. 01创建带标题和内容的文本笔记
  2. 02通过 note:// URI 访问笔记
  3. 03提供笔记元数据和纯文本内容
  4. 04整理全部笔记以供摘要

适用场景

  1. 01通过 MCP 客户端保存笔记
  2. 02按 URI 阅读已存笔记
  3. 03准备笔记内容供大模型摘要

MCP 相关

将笔记作为资源提供，并向 MCP 客户端提供 create_note 工具和 summarize_notes 提示词。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "flomo-mcp-hutusi": {
      "command": "npx",
      "args": [
        "-y",
        "@hutusi/flomo-mcp"
      ],
      "env": {
        "FLOMO_API_URL": "<FLOMO_API_URL>"
      }
    }
  }
}
启动命令npx -y @hutusi/flomo-mcp
需要配置的环境变量
FLOMO_API_URL

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@hutusi/flomo-mcp

工具

1

收录的工具列表 · 更新于 3 周前

参数类型必填说明
contentstring是备注文本内容

详细介绍

flomo-mcp MCP 服务

向 flomo 写入笔记

这是一个基于 TypeScript 的 MCP 服务，实现了一个简单的笔记系统。它通过提供以下功能来演示 MCP 的核心概念：

  • 表示文本笔记的资源，包含 URI 和元数据
  • 用于创建新笔记的工具
  • 用于生成笔记摘要的提示词

功能

资源
  • 通过 note:// URI 列出和访问笔记
  • 每条笔记都包含标题、内容和元数据
  • 使用纯文本 MIME 类型，便于访问内容
工具
  • create_note - 创建新的文本笔记
    • 必需参数为标题和内容
    • 将笔记存储在服务状态中
提示词
  • summarize_notes - 生成所有已存储笔记的摘要
    • 将所有笔记内容作为嵌入式资源包含在内
    • 返回用于大模型摘要的结构化提示词

开发

安装依赖：

npm install

构建服务：

npm run build

在开发过程中启用自动重新构建：

npm run watch

安装

要在 Claude Desktop 中使用，请添加服务配置：

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "flomo-mcp": {
      "command": "/path/to/flomo-mcp/build/index.js"
    }
  }
}
调试

由于 MCP 服务通过 stdio 通信，调试可能颇具挑战。我们建议使用 MCP Inspector，它可通过包脚本运行：

npm run inspector

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。