MCP Server for Flomo

基本能力

产品定位

mcp-server-flomo-python 是一个用于与 Flomo API 交互的工具，旨在帮助用户更方便地管理和添加笔记到 Flomo。

核心功能

1. 命令行工具：支持通过命令行直接写入笔记到 Flomo，支持从文件读取内容。
2. Web 服务器：提供 RESTful API 接口，支持通过 HTTP 请求写入笔记。
3. 配置管理：支持通过 .env 文件配置 Flomo API URL。
4. Markdown 支持：笔记内容支持 Markdown 格式。

适用场景

1. 个人笔记管理：快速添加笔记到 Flomo。
2. 自动化脚本：通过命令行或 API 自动化写入笔记。
3. 团队协作：通过 Web 服务器共享笔记写入功能。

工具列表

1. flomo-cli：命令行工具，支持测试连接、写入笔记等功能。
2. flomo-server：Web 服务器，提供 RESTful API 接口。

常见问题解答

1. Web 服务器无法启动：检查端口 12345 是否被占用。
2. API 连接失败：检查 .env 文件中的 FLOMO_API_URL 是否正确。
3. 笔记写入失败：确保 API URL 和权限设置正确。

使用教程

使用依赖

1. Python 环境：确保已安装 Python 3.6 或更高版本。
2. pip 工具：确保 pip 已安装并可用。

安装教程

从 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

调试方式

1. 测试连接

flomo-cli test

1. 写入笔记

flomo-cli write "这是一条测试笔记"

1. 启动 Web 服务器

flomo-server

1. 测试 API 接口

curl -X POST http://localhost:12345/write_note \
    -H "Content-Type: application/json" \
    -d '{"content": "这是一条测试笔记！"}'

许可证

该项目遵循 MIT 开源许可条款。