mcp-client-server-markdown

# mcp-client-server-markdown: A Markdown MCP client and server ## Project Introduction > MCP Markdown Server is a server application based on the Model Context Protocol (MCP), providing functionalities for Markdown document **creation**, **editing**, **searching**, **conversion to HTML**, and **management**. This project combines the MCP Client with the Spark large model and a custom MCP Server protocol to achieve intelligent Markdown document processing capabilities. ## Main Features ### 1. Markdown Document Management - **Create Document**: Create a new Markdown document through natural language instructions - **Edit Document**: Modify existing document content - **Delete Document**: Securely delete unnecessary documents - **Search Document**: Full-text search document content ### 2. Document Conversion - **Markdown to HTML**: Convert Markdown content to HTML format ### 3. Intelligent Templates - Provide various Markdown templates (articles, notes, to-do lists, meeting minutes, etc.) - Automatically generate document summaries ### 4. Conversational Interaction - Interact with the system through natural language - Support tool calls and context memory ## Technical Architecture - **Core Protocol**: Model Context Protocol (MCP) - **AI Capability**: Spark API - **Backend**: Node.js - **Storage**: Local File System ## Quick Start ### Prerequisites 1. Install Node.js (v16+) 2. Obtain Spark API Key (SPARK_API_KEY, SPARK_API_SECRET, SPARK_APP_ID) 3. Create a `.env` file and configure environment variables ### Installation and Running 1. Clone the repository: ```bash git clone https://github.com/your-repo/mcp-markdown-server.git cd mcp-markdown-server ``` 2. Install dependencies: ```bash npm install ``` 3. Start the server: ```bash node server.js ``` 4. Start the client: ```bash node client.js server.js ``` ## Usage Examples ### Create a New Document ```markdown > Please help me create a Markdown document about project planning, including API development and UI design ``` ### Search Documents ```markdown > Find all documents containing "API development" ``` ### Convert to HTML ```markdown > Convert the following Markdown to HTML: ## Title\n\nThis is a paragraph ``` ### Use Templates ```markdown > Create a new document using the meeting minutes template with the topic "Project Progress Meeting" ``` ## Project Structure ```markdown mcp-markdown-server/ ├── client.ts # MCP Client Implementation ├── server.ts # MCP Server Implementation ├── markdowns/ # Markdown Document Storage Directory ├── .env # Environment Variable Example ├── package.json # Project Dependencies └── README.md # Project Documentation ``` ## Contribution Guide Welcome to contribute! Please follow these steps: 1. Fork the project repository 2. Create a feature branch (`git checkout -b feature/AmazingFeature`) 3. Commit changes (`git commit -m 'Add some AmazingFeature'`) 4. Push to the branch (`git push origin feature/AmazingFeature`) 5. Open a Pull Request ## License This project is licensed under the MIT License. ## Certification This server is certified with [MCP Review](https://mcpreview.com/mcp-servers/zou-hong-run/mcp-client-server-markdown). ## Contact Information If you have any questions, please contact the project maintainer: - Email: zhr19853149156@163.com ------ **Note**: Ensure that the Spark API Key and local environment variables are correctly configured before use.