Metadata-Version: 2.4
Name: flomo-mcp-server
Version: 0.1.0
Summary: MCP server for flomo - 快速记录想法到 flomo
Project-URL: Homepage, https://github.com/Jiraiya8/flomo-mcp-server
Project-URL: Repository, https://github.com/Jiraiya8/flomo-mcp-server
Project-URL: Issues, https://github.com/Jiraiya8/flomo-mcp-server/issues
Author: Jiraiya8
License-Expression: MIT
License-File: LICENSE
Keywords: ai,claude,flomo,mcp,notes
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: httpx>=0.25.0
Requires-Dist: mcp>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# flomo MCP Server

MCP server for flomo - 让 AI 工具（如 Claude Code）能够快速向 flomo 添加笔记。

## 安装

### 使用 pip

```bash
pip install flomo-mcp-server
```

### 使用 uv（推荐）

```bash
uv pip install flomo-mcp-server
```

或者从源码安装：

```bash
uv sync
```

## 配置

### Claude Code

**方式 1: 已安装后运行**

```json
{
  "mcpServers": {
    "flomo": {
      "command": "flomo-mcp",
      "args": [],
      "env": {
        "FLOMO_API_URL": "https://flomoapp.com/iwh/你的专属URL/"
      }
    }
  }
}
```

**方式 2: 使用 uv run（无需预安装）**

```json
{
  "mcpServers": {
    "flomo": {
      "command": "uv",
      "args": ["run", "flomo-mcp"],
      "env": {
        "FLOMO_API_URL": "https://flomoapp.com/iwh/你的专属URL/"
      }
    }
  }
}
```

> 注意：使用 `uv run` 方式需要先克隆仓库并进入目录，或指定完整路径。

### 获取 API URL

1. 登录 flomo 网页版 (https://flomoapp.com)
2. 进入设置 -> API
3. 复制你的专属 API URL

## 使用示例

在 Claude Code 中：

> "帮我记录一条 flomo：今天学到了 MCP 协议的基本原理 #学习"

Claude 会调用 add_flomo 工具，将内容添加到你的 flomo。

## 工具说明

### add_flomo

向 flomo 添加一条笔记。

**参数：**
- `content` (必填): 要记录的内容，支持 Markdown 格式，可使用 #标签

**返回：**
- 成功: "已成功添加到 flomo"
- 失败: 错误描述信息

## API 限制

通过 API 每天最多发布 100 条，此限制由 flomo API 自动处理。

## 开发

### 使用 pip

安装开发依赖：

```bash
pip install -e ".[dev]"
```

运行测试：

```bash
pytest tests/ -v
```

### 使用 uv（推荐）

安装开发依赖：

```bash
uv sync
```

运行测试：

```bash
uv run pytest tests/ -v
```

## License

MIT