MCP-Flomo-Server
项目简介
MCP-Flomo-Server 是一个基于 Model Context Protocol (MCP) 的服务器应用，允许 AI 助手（如 Claude）直接将内容记录到 Flomo 笔记应用中。通过这个服务，用户可以在与 AI 对话过程中，轻松地将有价值的信息保存到 Flomo。
功能特点
- 提供 MCP 工具接口，支持 AI 助手直接调用
- 将内容通过 Flomo API 发送到用户的 Flomo 账户
- 支持环境变量配置，便于个性化设置
- 使用 TypeScript 开发，提供类型安全
安装
前提条件
- Node.js (v16 或更高版本)
- npm 或 yarn
- Flomo API 密钥 (通过 Flomo 网页版获取)
安装步骤
- 克隆仓库
git clone https://github.com/codeugar/mcp-flomo-server.git
cd mcp-flomo-server- 安装依赖
npm install- 配置 Flomo API
在 src/index.ts 文件中，直接修改 flomo_api 变量的值：
let flomo_api = ""使用方法
构建项目
npm run build在 AI 助手中使用
当服务器运行后，AI 助手可以通过 MCP 协议调用 flomo 工具，将内容记录到您的 Flomo 账户中。
示例调用：
记录到 Flomo: "这是一条测试笔记"技术栈
- TypeScript
- Node.js
- Model Context Protocol SDK
- Zod (用于数据验证)
项目结构
├── src/
│ └── index.ts # 主要服务器代码
├── build/ # 编译后的 JavaScript 文件
├── package.json # 项目依赖和脚本
└── tsconfig.json # TypeScript 配置许可证
ISC
贡献指南
欢迎提交 Issues 和 Pull Requests 来改进这个项目。
常见问题
Q: 如何获取 Flomo API 密钥？ A: 登录 Flomo 网页版，在设置中找到 API 选项，创建一个新的 API 密钥。
Q: 服务器启动后没有任何输出是正常的吗？ A: 是的，服务器启动后会等待 MCP 客户端的连接，没有额外的控制台输出是正常的。
Q: 如何确认服务器正在正常工作？ A: 您可以通过 AI 助手尝试发送一条笔记到 Flomo，然后检查您的 Flomo 账户是否收到了这条笔记。