mcp-client-server-markdown: A Markdown MCP client and server
Overview
基本能力
产品定位
mcp-client-server-markdown 是一个基于 MCP 协议的 Markdown 文档处理服务器，专注于提供智能化的文档管理和转换功能。
核心功能
- Markdown 文档管理
- 创建文档：通过自然语言指令创建新的 Markdown 文档
- 编辑文档：修改现有文档内容
- 删除文档：安全删除不再需要的文档
-
搜索文档：全文搜索文档内容
-
文档转换
-
Markdown 转 HTML：将 Markdown 内容转换为 HTML 格式
-
智能模板
- 提供多种 Markdown 模板（文章、笔记、待办事项、会议记录等）
-
自动生成文档摘要
-
对话式交互
- 通过自然语言与系统交互
- 支持工具调用和上下文记忆
适用场景
- 个人笔记管理：快速创建和编辑个人笔记
- 团队协作：使用模板创建会议记录或项目计划
- 文档转换：将 Markdown 转换为 HTML 用于网页发布
- 内容生成：利用 AI 能力自动生成文档内容
工具列表
- client.ts：MCP 客户端实现
- server.ts：MCP 服务器实现
- markdowns/：Markdown 文档存储目录
常见问题解答
- 如何获取星火 API 密钥？
- 需要联系讯飞获取 SPARK_API_KEY, SPARK_API_SECRET, SPARK_APP_ID
- 如何配置环境变量？
- 创建
.env文件并按照示例配置环境变量
使用教程
使用依赖
-
安装 Node.js (v16+)
bash # 在 Ubuntu 上安装 Node.js sudo apt update sudo apt install nodejs sudo apt install npm -
获取星火 API 密钥 (SPARK_API_KEY, SPARK_API_SECRET, SPARK_APP_ID)
-
创建
.env文件并配置环境变量bash # 示例 .env 文件内容 SPARK_API_KEY=your_api_key SPARK_API_SECRET=your_api_secret SPARK_APP_ID=your_app_id
安装教程
-
克隆仓库：
bash git clone https://github.com/your-repo/mcp-markdown-server.git cd mcp-markdown-server -
安装依赖：
bash npm install -
启动服务器：
bash node server.js -
启动客户端：
bash node client.js server.js
调试方式
-
检查服务器是否运行：
bash ps aux | grep node -
检查端口是否监听：
bash netstat -tulnp | grep node -
查看日志：
bash tail -f server.log