MCP Server for Flomo
这个项目提供了一个基于MCP (Model Context Protocol)的Web服务器和命令行工具，用于与Flomo API交互，以便在不同环境中方便地添加笔记到Flomo。
安装
从PyPI安装（推荐）
# 安装基本包
pip install mcp-server-flomo
# 安装开发依赖（可选）
pip install mcp-server-flomo[dev]从源码安装
git clone https://github.com/yourusername/mcp-server-flomo-python.git
cd mcp-server-flomo-python
pip install -r requirements.txt项目结构
.
├── flomo_cli.py # 命令行工具入口脚本
├── flomo_server.py # Web服务器入口脚本
├── src # 源代码目录
│ ├── cli # 命令行工具模块
│ │ ├── __init__.py
│ │ ├── __main__.py # CLI主入口
│ │ └── commands.py # CLI命令实现
│ ├── server # Web服务器模块
│ │ ├── __init__.py
│ │ ├── __main__.py # 服务器主入口
│ │ └── app.py # Flask应用实现
│ └── utils # 工具模块
│ ├── __init__.py
│ ├── config.py # 配置管理
│ └── flomo_client.py # Flomo API客户端
├── tests # 测试目录
└── docs # 文档目录配置
- 在项目根目录创建
.env文件：
FLOMO_API_URL=https://flomoapp.com/iwh/你的ID/你的API密钥/注意：FLOMO_API_URL 是必需的，你可以从 Flomo 网站的 设置 > API 页面获取。
使用方法
命令行工具
安装后，你可以直接使用 flomo-cli 命令：
# 测试连接
flomo-cli test
# 发送笔记
flomo-cli write "这是一条测试笔记"
# 从文件读取内容
flomo-cli write -f notes.mdWeb服务器
安装后，你可以直接使用 flomo-server 命令启动服务器：
flomo-server或者使用参数：
flomo-server --port 8080 --host 127.0.0.1服务器默认在 http://localhost:12345 上运行，提供以下端点：
GET /- 显示使用说明GET /test- 测试服务器连接POST /write_note- 写入笔记到 Flomo
示例：写入笔记
curl -X POST http://localhost:12345/write_note \
-H "Content-Type: application/json" \
-d '{"content": "这是一条测试笔记！\n\n支持 **Markdown** 格式\n- 列表1\n- 列表2\n\n> 引用文本"}'开发
安装开发依赖
pip install -r requirements.txt运行测试
pytest代码格式化
black .类型检查
mypy src故障排除
- 如果 Web 服务器无法启动，请检查端口 12345 是否已被占用
- 如果连接到 Flomo API 失败，请检查 API URL 是否正确
- 确保
.env文件中的 FLOMO_API_URL 设置正确
贡献
欢迎提交 Issue 和 Pull Request！
许可证
本项目采用 MIT 许可证。详见 LICENSE 文件。