mcp-client -markdown

This MCP server provides a Markdown document management system powered by the Model Context Protocol (MCP). It supports creating, editing, deleting, and searching Markdown documents, as well as converting Markdown to HTML and utilizing intelligent templates with summary generation. The server integrates with the Spark large model API to enable smart content generation and conversational interactions, and it stores documents on the local filesystem. You can interact with the server via MCP clients, issue natural language prompts to create or modify documents, request full-text searches, and trigger conversions to HTML. The tooling enables templates for articles, notes, to-dos, and meeting notes, along with dialogue-style interactions and context memory to maintain continuity across sessions.

Prerequisites:

• Node.js v16+ installed on your system
• Git available to clone the repository
• Access to Spark API credentials (SPARK_API_KEY, SPARK_API_SECRET, SPARK_APP_ID)

Installation steps:

1. Clone the repository git clone https://github.com/your-repo/mcp-markdown-server.git cd mcp-markdown-server

2. Install dependencies npm install

3. Configure environment variables Create a .env file (or set environment variables in your shell) with: SPARK_API_KEY=your_key SPARK_API_SECRET=your_secret SPARK_APP_ID=your_app_id

4. Start the MCP server node server.js

5. (Optional) Run the MCP client against the server node client.js server.js

Notes:

• Ensure your Spark API credentials are valid and have access to the Spark API endpoints used by this server.
• The server stores Markdown documents on the local filesystem (configured by defaults unless overridden).

Tips and common issues:

• If the server fails to start, verify that Node.js is v16+ and that you have network access to the Spark API endpoints.
• Ensure the .env file (or environment variables) provides SPARK_API_KEY, SPARK_API_SECRET, and SPARK_APP_ID; missing credentials will prevent smart features from working.
• The project uses a local 'markdowns/' directory for storage; ensure the process has read/write permissions to this folder.
• When converting Markdown to HTML, confirm that any required Markdown extensions are supported by the server’s converter.
• If you need to run behind a reverse proxy, consider configuring environment variables or server options accordingly (e.g., PORT, HOST).
• For upgrades, pull latest changes and reinstall dependencies (npm install).