MCP 服务器

Flomo Go Tools

jamesfeng2009

开发者工具

访问服务器

README

Flomo Go 工具

这是一个用 Go 语言开发的 Flomo 工具集，提供命令行工具和 MCP 服务器两种方式来发送笔记到 Flomo。

功能特点

📝 支持通过命令行快速发送笔记
🏷️ 支持添加标签
🔌 提供 MCP 服务器集成
📊 详细的日志记录
🌈 友好的命令行界面

安装

克隆仓库：

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

设置环境变量：

cp .env.example .env

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

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

编译 CLI 工具：

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

使用方法

CLI 工具

基本使用：

./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 (string) - 笔记内容，支持 Markdown 格式

项目结构

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

开发

代码风格遵循 Go 标准
使用 go fmt 格式化代码
确保所有日志信息清晰可读

示例输出

Note sent successfully! 🎉
Created at: 2025-04-16 00:35:06
Tags: 测试
View at: https://v.flomoapp.com/mine/?memo_id=xxx

Detailed information:
- Source: incoming_webhook
- Creator ID: xxx
- Response code: 0
- Response message: 已记录
- Total time: 896.754667ms

注意事项

请妥善保管你的 Flomo API URL，不要分享给他人
建议在发送大量笔记时适当控制频率
如果遇到问题，可以使用 -v 参数查看详细日志

许可证

MIT License


翻译后的中文：

# Flomo Go 工具

这是一个用 Go 语言开发的 Flomo 工具集，提供命令行工具和 MCP 服务器两种方式来发送笔记到 Flomo。

## 功能特点

- 📝 支持通过命令行快速发送笔记
- 🏷️ 支持添加标签
- 🔌 提供 MCP 服务器集成
- 📊 详细的日志记录
- 🌈 友好的命令行界面

## 安装

1. 克隆仓库：
```bash
git clone https://github.com/yourusername/mcp-server-flomo-go.git
cd mcp-server-flomo-go

设置环境变量：

cp .env.example .env

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

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

编译 CLI 工具：

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

使用方法

CLI 工具

基本使用：

./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 (string) - 笔记内容，支持 Markdown 格式

项目结构

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

开发

代码风格遵循 Go 标准
使用 go fmt 格式化代码
确保所有日志信息清晰可读

示例输出

Note sent successfully! 🎉
Created at: 2025-04-16 00:35:06
Tags: 测试
View at: https://v.flomoapp.com/mine/?memo_id=xxx

Detailed information:
- Source: incoming_webhook
- Creator ID: xxx
- Response code: 0
- Response message: 已记录
- Total time: 896.754667ms