Thank you for your interest in contributing to the Meilisearch MCP Server! This document provides guidelines and instructions for contributing.
Please be respectful and considerate of others when contributing to this project. We aim to foster an inclusive and welcoming community.
- Fork the repository
- Clone your fork:
git clone https://github.com/devlimelabs/meilisearch-ts-mcp.git - Navigate to the project directory:
cd meilisearch-ts-mcp - Install dependencies:
npm install - Create a new branch for your feature or bugfix:
git checkout -b feature/your-feature-name
- Make your changes
- Run the linter:
npm run lint - Run tests:
npm test - Build the project:
npm run build - Test your changes with a local Meilisearch instance
- Ensure your code passes all tests and linting
- Update documentation if necessary
- Submit a pull request to the
mainbranch - Describe your changes in detail in the pull request description
- Reference any related issues
When adding new tools to the MCP server:
- Create a new file in the
src/toolsdirectory if appropriate - Follow the existing pattern for tool registration
- Use Zod for parameter validation
- Add proper error handling
- Update the README.md to document the new tool
- Use TypeScript for all new code
- Follow the existing code style
- Write meaningful commit messages
- Add comments for complex logic
- Write tests for new functionality
- Write unit tests for new functionality
- Ensure all tests pass before submitting a pull request
- Test with a real Meilisearch instance when possible
- Update the README.md file with any new features or changes
- Document all new tools and parameters
- Provide examples for complex functionality
By contributing to this project, you agree that your contributions will be licensed under the project's MIT license.