mcp-server-flomo-go

🚀 Flomo 命令行工具集

这是一个用 Go 语言开发的 Flomo 工具集合，它支持通过命令行工具和 MCP 服务器两种方式，将笔记轻松发送到 Flomo，为你的笔记记录带来更多便利。

🚀 快速开始

本工具集支持通过命令行工具和 MCP 服务器两种方式将笔记发送到 Flomo。你可以按照以下安装和使用说明进行操作。

✨ 主要特性

• 📝 支持快速通过命令行创建笔记
• 🏷️ 可添加标签功能
• 🔌 提供 MCP 服务器集成
• 📊 详细的日志记录功能
• 🌈 友好的命令行界面设计

📦 安装指南

1. 克隆代码仓库：

git clone https://github.com/yourusername/mcp-server-flomo-go.git
cd mcp-server-flomo-go

2. 配置环境变量：

cp .env.example .env

编辑 .env 文件，添加你的 Flomo API 地址：

FLOMO_API_URL=https://flomoapp.com/iwh/xxx/xxx

3. 编译 CLI 工具：

go build -o mcp-server-flomo-go cmd/flomo/main.go

💻 使用示例

命令行工具

基础用法

./flomo -c "你的笔记内容"

高级用法

• 添加标签：

./flomo -c "笔记内容" -t "标签1,标签2"

• 从标准输入读取内容：

echo "笔记内容" | ./flomo

• 显示详细信息：

./flomo -c "笔记内容" -v

命令行参数说明

• -c, --content：必需，设置笔记内容
• -t, --tags：可选，设置标签列表（用逗号分隔）
• -v, --verbose：可选，显示详细日志信息
• -h, --help：显示帮助信息

MCP 服务器

基础用法

启动服务器：

go run server.go

高级用法

提供的工具命令：

• write_note：写入笔记内容
  • 参数：content（字符串）- 支持 Markdown 格式的笔记内容

📚 详细文档

项目结构

.
├── cmd
│   └── flomo
│       └── main.go    # 命令行工具实现文件
├── pkg
│   └── flomo
│       └── client.go  # Flomo API 客户端实现文件
├── server.go          # MCP 服务器实现文件
├── .env              # 环境变量配置文件
└── README.md         # 本指南文档

开发规范

1. 遵循 Go 语言代码规范和标准库风格
2. 使用 go fmt 格式化代码
3. 确保所有日志信息清晰易读

示例输出

笔记发送成功！🎉
创建时间：2025-04-16 00:35:06
标签：测试
查看链接：https://v.flomoapp.com/mine/?memo_id=xxx

详细信息：
- 来源：incoming_webhook
- 创建者 ID：xxx
- 响应状态码：0
- 响应消息：已记录
- 总耗时：896.754667ms

注意事项

⚠️ 重要提示

请妥善保管你的 Flomo API 地址，避免泄露给他人。建议在发送大量笔记时控制频率。如遇问题，请使用 -v 参数查看详细日志信息。

📄 许可证

本项目采用 MIT License 开源协议。