flomo-mcp-server 0.1.0__tar.gz

flomo_mcp_server-0.1.0/.claude/settings.local.json

@@ -0,0 +1,20 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git init:*)",
+      "Bash(git add:*)",
+      "Bash(git commit -m 'Add flomo MCP server design spec:*)",
+      "mcp__tavily__tavily_search",
+      "Bash(dir /s src)",
+      "Bash(pip install:*)",
+      "Bash(pytest tests/test_client.py::test_client_missing_api_url -v)",
+      "Bash(pytest tests/test_client.py -v)",
+      "Bash(python -m py_compile src/flomo_mcp/client.py)",
+      "Bash(xxd -l 10 src/flomo_mcp/client.py)",
+      "Bash(xxd)",
+      "Bash(python -c \"from src.flomo_mcp.server import server, main, list_tools, call_tool, run_server; print\\('Import check passed'\\)\")",
+      "Bash(pytest tests/ -v)",
+      "Bash(pip show:*)"
+    ]
+  }
+}

flomo_mcp_server-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Jiraiya8
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

flomo_mcp_server-0.1.0/PKG-INFO

@@ -0,0 +1,153 @@
+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

flomo_mcp_server-0.1.0/README.md

@@ -0,0 +1,126 @@
+# 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