mcp-client-server-markdown: 基于MCP协议的Markdown客户端和服务器

项目介绍

MCP Markdown Server 是一款基于模型上下文协议（MCP）的服务器应用程序，提供Markdown文档处理功能，包括创建、编辑、搜索、转换为HTML和管理。该项目通过结合iFlytek Spark大模型MCP客户端和自定义MCP服务器协议，实现了智能Markdown文档处理能力。

主要功能

1. Markdown文档管理

• 创建文档使用自然语言命令创建新的Markdown文档
• 编辑文档修改现有文档内容
• 删除文档安全地删除不再需要的文档
• 搜索文档全文搜索文档内容

2. 文档转换

• Markdown到HTML转换将Markdown内容转换为HTML格式

3. 智能模板

• 提供多种Markdown模板（文章、笔记、待办事项、会议纪要等）
• 自动生成文档摘要

4. 对话式交互

• 通过自然语言与系统进行交互
• 支持工具调用和上下文记忆

技术架构

• 核心协议：模型上下文协议（MCP）
• AI能力：Spark API（Spark API）
• 后端：Node.js
• 存储：本地文件系统

快速开始

预条件

1. 安装Node.js（v16+）
2. 获取Spark API密钥（SPARK-API_KEY, SPARK-API_SCRET, SPARK-APP-ID）
3. 创建.env文件并配置环境变量

安装和运行

1. 克隆仓库：

   git clone https://github.com/your-repo/mcp-markdown-server.git
   cd mcp-markdown-server
   

2. 安装依赖：

   npm install
   

3. 启动服务器：

   node server.js
   

4. 启动客户端：

   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        # 项目文档

贡献指南

欢迎贡献！请遵循以下步骤：

1. 分叉项目仓库
2. 创建特性分支（git checkout -b feature/AmazingFeature）
3. 提交更改（git commit -m 'Add some AmazingFeature'）
4. 推送到分支（git push origin feature/AmazingFeature）
5. 打开拉取请求

许可证

本项目采用MIT许可证。

认证

此服务器已通过MCP审核认证。

联系信息

如有任何问题，请联系项目维护者：

• 邮箱：zhr19853149156@163.com

---

提示请确保在使用前已正确配置Spark API密钥和本地环境变量。