feat(mcp-server): add HackMD mcp server (#2260)

This commit is contained in:
Whitea
2025-05-22 16:53:01 +08:00
committed by GitHub
parent fa3c5ea0fc
commit 031ae21caa
3 changed files with 311 additions and 0 deletions

View File

@@ -0,0 +1,48 @@
# HackMD MCP Server
基于 HackMD API 的 MCP 服务器实现,通过 MCP 协议与 HackMD 平台进行交互。HackMD 是一个实时、多平台的协作 Markdown 知识库,可以让用户在桌面、平板或手机上与他人共同编写文档。
## 功能
HackMD MCP Server 提供了以下功能:
- **用户数据**:获取用户个人信息和相关配置。
- `get_me`:获取用户数据。
- **笔记管理**:创建、读取、更新和删除个人笔记。
- `get_notes`:获取用户的笔记列表。
- `post_notes`:创建新笔记。
- `get_notes_noteId`:通过 ID 获取特定笔记。
- `patch_notes_noteId`:更新笔记内容。
- `delete_notes_noteId`:删除笔记。
- **团队协作**:处理团队笔记相关操作。
- `get_teams`:获取用户参与的团队列表。
- `get_teams_teamPath_notes`:获取团队中的笔记列表。
- `patch_teams_teamPath_notes_noteId`:更新团队中的笔记内容。
- `delete_teams_teamPath_notes_noteId`:从团队中删除笔记。
- **浏览历史**:查看用户的历史记录。
- `get_history`:获取用户的浏览历史。
## 使用教程
### 获取 AccessToken
参考 [HackMD API 文档](https://hackmd.io/@hackmd-api/developer-portal/https%3A%2F%2Fhackmd.io%2F%40hackmd-api%2FrkoVeBXkq) 获取 AccessToken。
### 生成 SSE URL
在 MCP Server 界面,登录后输入 AccessToken生成URL。
### 配置 MCP Client
在用户的 MCP Client 界面,将生成的 SSE URL添加到 MCP Server列表中。
``` json
"mcpServers": {
"hackmd": {
"url": "https://mcp.higress.ai/mcp-hackmd/{generate_key}",
}
}
```