mcp-server
This project is an MCP server providing a variety of tools for checking links in Markdown files. It supports manual use and integration with Cursor, leveraging the Model Context Protocol for communication.
Overview
This project hosts a general MCP server aimed at providing tools for AI agents, using the Model Context Protocol (MCP) for communication. It offers a suite of tools for checking links in Markdown files, either in single files, lists of files, directories, or across the entire project. It uses uv for environment and dependency management and includes facilities for testing and code linting using pytest and ruff, respectively. The server can operate manually via Makefile commands and is designed to integrate with Cursor for extended functionalities.
Tools Provided
- check_markdown_link_file: Checks HTTP/HTTPS links in a specified Markdown file.
- check_markdown_link_files: Checks links within a list of Markdown files.
- check_markdown_link_directory: Recursively scans a directory for Markdown files to check links.
- check_markdown_links_project: Scans the entire project for Markdown files (respecting
.gitignore) to check links.
Setup & Usage
- Navigate to the project directory and install dependencies using
uv. - Execute tests and check code coverage.
- Run lint and format checks using
ruff. - Run the server manually or integrate with Cursor as an MCP tool.
Contributing
Contributions are encouraged. Ensure all tests pass before submission.
License
Specify your license here.
Integration Notes
- Ensure absolute paths are configured correctly in
~/.cursor/mcp.jsonfor Cursor MCP integration. - Implement and test new tools following guidelines provided in the README.