mcp-client-server-markdown: A Markdown MCP client and server
项目简介
MCP Markdown Server 是一个基于 Model Context Protocol (MCP) 的服务器应用，提供 Markdown 文档的创建、编辑、搜索、转换为html和管理的功能。该项目通过了结合了讯飞星火大模型的 MCP Client 以及自定义 MCP Server 协议，实现了智能化的 Markdown 文档处理能力。
主要功能
1. Markdown 文档管理
- 创建文档：通过自然语言指令创建新的 Markdown 文档
- 编辑文档：修改现有文档内容
- 删除文档：安全删除不再需要的文档
- 搜索文档：全文搜索文档内容
2. 文档转换
- Markdown 转 HTML：将 Markdown 内容转换为 HTML 格式
3. 智能模板
- 提供多种 Markdown 模板（文章、笔记、待办事项、会议记录等）
- 自动生成文档摘要
4. 对话式交互
- 通过自然语言与系统交互
- 支持工具调用和上下文记忆
技术架构
- 核心协议：Model Context Protocol (MCP)
- AI 能力：星火大模型 API (Spark API)
- 后端：Node.js
- 存储：本地文件系统
快速开始
前置条件
- 安装 Node.js (v16+)
- 获取星火 API 密钥 (SPARK_API_KEY, SPARK_API_SECRET, SPARK_APP_ID)
- 创建
.env文件并配置环境变量
安装与运行
- 克隆仓库：
git clone https://github.com/your-repo/mcp-markdown-server.git
cd mcp-markdown-server- 安装依赖：
npm install- 启动服务器：
node server.js- 启动客户端：
node client.js server.js使用示例
创建新文档
> 请帮我创建一个关于项目计划的Markdown文档，包含API开发和UI设计两部分搜索文档
> 查找所有包含"API开发"的文档转换为HTML
> 将以下Markdown转换为HTML: ## 标题\n\n这是一个段落使用模板
> 使用会议记录模板创建一个新的文档，主题是"项目进度会议"项目结构
mcp-markdown-server/
├── client.ts # MCP客户端实现
├── server.ts # MCP服务器实现
├── markdowns/ # Markdown文档存储目录
├── .env # 环境变量示例
├── package.json # 项目依赖
└── README.md # 项目文档贡献指南
欢迎贡献！请遵循以下步骤：
- Fork 项目仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 打开 Pull Request
许可证
本项目采用 MIT 许可证。
Certification
This server is certified with MCP Review.
认证
本服务器已通过 MCP Review 认证。
联系方式
如有任何问题，请联系项目维护者：
- 邮箱: zhr19853149156@163.com
提示：使用前请确保已正确配置星火 API 密钥和本地环境变量。