Universal Clipboard MCP
Universal Clipboard MCP is a powerful MCP server designed for seamless content transfer and format conversion. It allows developers and content creators to effortlessly convert content between various formats, including Markdown, HTML, and DOCX, directly within their development environment.
This tool is built to be highly extensible, allowing for the easy addition of new format converters and content processors to meet the evolving needs of any project.
Features
- Multi-format Conversion: Convert content between a wide range of formats.
- Format Detection: Automatically detect the format of a given piece of content.
- Batch Conversion: Process multiple conversion requests in a single call.
- Extensible: Easily add new format converters and content processors.
Supported Formats
The following formats are supported for conversion:
- Markdown
- HTML
- Plain Text
- JSON
- Slack Markdown
- GitHub Flavored Markdown
- JIRA Syntax
- Notion Blocks
- Linear Format
- DOCX
- AsciiDoc
Installation
To get started, install the necessary dependencies:
npm install
Usage
The core feature of this MCP server is the convert_content tool. Here’s a basic example of how to use it to convert Markdown to HTML:
// Example of using the 'convert_content' tool
const convertedContent = await mcp.useTool('universal-clipboard-mcp', 'convert_content', {
content: '# Hello, World!',
sourceFormat: 'markdown',
targetFormat: 'html'
});
console.log(convertedContent);
// Output: '<h1>Hello, World!</h1>'
API
Tools
convert_content: Transforms content from a source format to a target format.content(string): The content to convert.sourceFormat(string): The source format of the content.targetFormat(string): The target format for the conversion.
detect_format: Identifies the format of a given piece of content.content(string): The content to analyze.
list_supported_formats: Lists all supported content formats for conversion.preview_conversion: Shows a preview of how content will look after conversion without saving.content(string): The content to convert.sourceFormat(string): The source format of the content.targetFormat(string): The target format for the conversion.
convert_batch: Processes multiple conversion requests in a single call.requests(array): An array of conversion request objects.
Development
To build the project, run the following command:
npm run build
To run the test suite:
npm test
Configuration
VS Code
For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open Settings (JSON).
{
"mcp": {
"servers": {
"universal-clipboard-mcp": {
"command": "npm",
"args": [
"start"
],
"env": {
"PATH": "${env:PATH}"
}
}
}
}
}
Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"universal-clipboard-mcp": {
"command": "npm",
"args": [
"start"
],
"env": {
"PATH": "${env:PATH}"
}
}
}
}
Contributing
Contributions are welcome! Please feel free to submit a pull request or open an issue if you have ideas for improvements or have found a bug.
License
This project is licensed under the MIT License.