Skip to content

Commit 7015e68

Browse files
rsonghusterrsonghuster
committed
add flomo
1 parent 0e0cccb commit 7015e68

9 files changed

Lines changed: 481 additions & 0 deletions

File tree

‎README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,7 @@ MCP 协议中有 STDIO 与 SSE 两种传输机制，大致如下:
4444
- Json: [start-mcp-json](./start-mcp-json/src)
4545
- Figma-Context-MCP: [start-mcp-figma](./start-mcp-figma/src)
4646
- Notion: [start-mcp-notion](./start-mcp-notion/src)
47+
- Flomo: [start-mcp-flomo](./start-mcp-flomo/src)
4748

4849
其中有 hello-world 示例:
4950

‎start-mcp-flomo/README.md‎

Lines changed: 174 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,174 @@
1+
2+
> 注：当前项目为 Serverless Devs 应用，由于应用中会存在需要初始化才可运行的变量（例如应用部署地区、函数名等等），所以**不推荐**直接 Clone 本仓库到本地进行部署或直接复制 s.yaml 使用，**强烈推荐**通过 `s init ${模版名称}` 的方法或应用中心进行初始化，详情可参考[部署 & 体验](#部署--体验) 。
3+
4+
# start-mcp-flomo 帮助文档
5+
6+
<description>
7+
8+
Flomo MCP Server
9+
10+
</description>
11+
12+
13+
## 资源准备
14+
15+
使用该项目，您需要有开通以下服务并拥有对应权限：
16+
17+
<service>
18+
19+
20+
21+
| 服务/业务 | 权限 | 相关文档 |
22+
| --- | --- | --- |
23+
| 函数计算 | AliyunFCFullAccess | [帮助文档](https://help.aliyun.com/product/2508973.html) [计费文档](https://help.aliyun.com/document_detail/2512928.html) |
24+
25+
</service>
26+
27+
<remark>
28+
29+
30+
31+
</remark>
32+
33+
<disclaimers>
34+
35+
36+
37+
</disclaimers>
38+
39+
## 部署 & 体验
40+
41+
<appcenter>
42+
43+
- :fire: 通过 [云原生应用开发平台 CAP](https://cap.console.aliyun.com/template-detail?template=start-mcp-flomo) ，[![Deploy with Severless Devs](https://img.alicdn.com/imgextra/i1/O1CN01w5RFbX1v45s8TIXPz_!!6000000006118-55-tps-95-28.svg)](https://cap.console.aliyun.com/template-detail?template=start-mcp-flomo) 该应用。
44+
45+
</appcenter>
46+
<deploy>
47+
48+
49+
</deploy>
50+
51+
## 案例介绍
52+
53+
<appdetail id="flushContent">
54+
55+
# Flomo MCP Server
56+
57+
58+
https://github.com/xianminx/mcp-server-flomo
59+
60+
A Model Context Protocol (MCP) server that lets you create notes in Flomo directly through AI chat interactions in Cursor or Claude desktop. Write and organize your thoughts seamlessly through natural language commands.
61+
62+
## Usage
63+
64+
### Installing via Smithery
65+
66+
To install mcp-server-flomo for Claude Desktop automatically via [Smithery](https://smithery.ai/server/mcp-server-flomo/wss://mcp.smithery.ai:443):
67+
68+
```bash
69+
npx -y @smithery/cli install mcp-server-flomo --client claude
70+
```
71+
72+
### [mcp-get](https://mcp-get.com/)
73+
74+
![mcp-get: mcp-server-flomo](https://img.shields.io/badge/mcp--get-mcp--server--flomo-blue)
75+
76+
77+
```bash
78+
npx @michaellatman/mcp-get@latest install mcp-server-flomo
79+
```
80+
81+
### [mcp.so](https://mcp.so/server/mcp-server-flomo/xianminx)
82+
https://mcp.so/protocol/mcp-server-flomo/wss://mcp.smithery.ai:443
83+
84+
### Manually configure
85+
86+
Configure Claude / Cursor / Windsurf / Cline / ChatWise / Cherry Studio etc.
87+
88+
```bash
89+
FLOMO_API_URL=your_api_url_here npx mcp-server-flomo
90+
```
91+
92+
Or configure for your MCP Host / Client. See https://mcp.so/protocol/mcp-server-flomo/wss://mcp.smithery.ai:443 for configuration detail.
93+
94+
Get your Flomo API URL from [Flomo API Settings](https://v.flomoapp.com/mine)
95+
96+
```json
97+
{
98+
"mcpServers": {
99+
"mcp-server-flomo": {
100+
"command": "npx",
101+
"args": [
102+
"mcp-server-flomo"
103+
],
104+
"env": {
105+
"FLOMO_API_URL": "your_api_url_here"
106+
}
107+
}
108+
}
109+
}
110+
```
111+
112+
Once the server is running, you can create notes in Flomo through natural language commands in your AI chat. Here are some examples:
113+
114+
```json
115+
"How to publish a mcp server? Could you save the answer to flomo note after answering it"
116+
```
117+
118+
This will save the Cursor AI Agent response to Flomo directly in the chat conversation!
119+
120+
121+
<img src="https://raw.githubusercontent.com/xianminx/mcp-server-flomo/refs/heads/main/public/images/mcp-cursor-flomo.png" width="400">
122+
123+
The server will handle:
124+
125+
- Converting your natural language requests into Flomo API calls
126+
- Proper formatting and submission of your notes
127+
- Providing feedback on successful note creation
128+
129+
## Dev
130+
131+
1. Get your Flomo API URL from [Flomo API Settings](https://v.flomoapp.com/mine)
132+
133+
2. Install and configure:
134+
135+
```bash
136+
# Install dependencies
137+
npm install
138+
FLOMO_API_URL=your_api_url_here npx .
139+
```
140+
141+
## Technical Details
142+
143+
- Built with TypeScript and the Model Context Protocol SDK
144+
- Communicates with Flomo via their REST API
145+
- Runs over stdio for seamless integration with AI tools
146+
147+
## License
148+
149+
This project is licensed under the MIT License—see the [LICENSE](LICENSE) file for details.
150+
151+
</appdetail>
152+
153+
154+
155+
156+
157+
158+
159+
## 使用流程
160+
161+
<usedetail id="flushContent">
162+
163+
部署完成拿到 URL 后，准备好支持 SSE 的 MCP Client，通过 SSETransport 进行连接。
164+
165+
</usedetail>
166+
167+
168+
169+
170+
171+
172+
173+
174+

‎start-mcp-flomo/hook/index.js‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
async function preInit(inputObj) {
2+
3+
}
4+
5+
async function postInit(inputObj) {
6+
7+
}
8+
9+
module.exports = {
10+
postInit,
11+
preInit
12+
}

‎start-mcp-flomo/publish.yaml‎

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
Edition: 3.0.0
2+
Type: Project
3+
Name: start-mcp-flomo
4+
Version: 0.0.1
5+
Provider:
6+
- 阿里云 # 取值内容参考：https://api.devsapp.cn/v3/common/args.html
7+
Description: Flomo MCP Server
8+
HomePage: https://github.com/xianminx/mcp-server-flomo
9+
Tags: #标签详情
10+
- MCP
11+
- Serverless Devs
12+
Category: AI工具 # 取值内容参考：https://api.devsapp.cn/v3/common/args.html
13+
Service: # 使用的服务
14+
函数计算: # 取值内容参考：https://api.devsapp.cn/v3/common/args.html
15+
Authorities: #权限描述
16+
- AliyunFCFullAccess # 所需要的权限，例如AliyunFCFullAccess
17+
Organization: 阿里云函数计算（FC） # 所属组织
18+
Effective: Public # 是否公开，取值：Public，Private，Organization
19+
Parameters:
20+
type: object
21+
additionalProperties: false # 不允许增加其他属性
22+
required: # 必填项
23+
- region
24+
- functionName
25+
- FLOMO_API_URL
26+
properties:
27+
region:
28+
title: 地域
29+
type: string
30+
default: cn-hangzhou
31+
description: 创建应用所在的地区
32+
enum:
33+
- cn-beijing
34+
- cn-hangzhou
35+
- cn-shanghai
36+
- cn-shenzhen
37+
- ap-southeast-1
38+
functionName:
39+
title: 函数名
40+
type: string
41+
default: mcp-server-${default-suffix}
42+
pattern: "^[a-zA-Z_][a-zA-Z0-9-_]{0,127}$"
43+
description: 应用的函数名称, 只能包含字母、数字、下划线和中划线。不能以数字、中划线开头。长度在 1-128 之间
44+
FLOMO_API_URL:
45+
title: FLOMO_API_URL
46+
type: string
47+
default: ''
48+
sensitive: 'true'
49+
description: 获取 Flomo API URL, 参考 https://v.flomoapp.com/mine

‎start-mcp-flomo/src/build.yaml‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
start-mcp-server:
2+
default:
3+
languages:
4+
- nodejs20
5+
cache:
6+
paths:
7+
- "~/.npm"
8+
steps:
9+
- run: npm install
10+
path: ./code

‎start-mcp-flomo/src/code/package.json‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
{
2+
"dependencies": {
3+
"mcp-server-flomo": "^0.0.11"
4+
}
5+
}

0 commit comments

Comments
 (0)