{"id":23895344,"url":"https://github.com/wrale/mcp-server-make","last_synced_at":"2026-04-09T04:06:55.784Z","repository":{"id":268611648,"uuid":"904533816","full_name":"wrale/mcp-server-make","owner":"wrale","description":"MCP Server for GNU Make","archived":false,"fork":false,"pushed_at":"2025-03-16T03:38:57.000Z","size":232,"stargazers_count":5,"open_issues_count":0,"forks_count":3,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-09-28T13:06:42.702Z","etag":null,"topics":["ai-assistant","build-system","build-tools","claude","claude-ai","claude-desktop","coding-assistant","gnu-make","make","makefiles","mcp","model-context-protocol","model-context-protocol-servers"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wrale.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-12-17T04:42:21.000Z","updated_at":"2025-09-16T08:42:45.000Z","dependencies_parsed_at":"2024-12-17T21:27:06.409Z","dependency_job_id":"500ac957-aa15-444c-94ac-2a8426613e60","html_url":"https://github.com/wrale/mcp-server-make","commit_stats":null,"previous_names":["wrale/mcp-server-make"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/wrale/mcp-server-make","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wrale%2Fmcp-server-make","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wrale%2Fmcp-server-make/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wrale%2Fmcp-server-make/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wrale%2Fmcp-server-make/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wrale","download_url":"https://codeload.github.com/wrale/mcp-server-make/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wrale%2Fmcp-server-make/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31584878,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"online","status_checked_at":"2026-04-09T02:00:06.848Z","response_time":112,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-assistant","build-system","build-tools","claude","claude-ai","claude-desktop","coding-assistant","gnu-make","make","makefiles","mcp","model-context-protocol","model-context-protocol-servers"],"created_at":"2025-01-04T15:55:30.468Z","updated_at":"2026-04-09T04:06:55.767Z","avatar_url":"https://github.com/wrale.png","language":"Python","readme":"# MCP Server Make\n\n[![CI](https://github.com/wrale/mcp-server-make/actions/workflows/ci.yml/badge.svg)](https://github.com/wrale/mcp-server-make/actions/workflows/ci.yml)\n[![Release](https://github.com/wrale/mcp-server-make/actions/workflows/release.yml/badge.svg)](https://github.com/wrale/mcp-server-make/actions/workflows/release.yml)\n[![PyPI version](https://badge.fury.io/py/mcp-server-make.svg)](https://badge.fury.io/py/mcp-server-make)\n\nA Model Context Protocol server that provides make functionality. This server enables LLMs to execute make targets from any Makefile in a safe, controlled way.\n\n\u003ca href=\"https://glama.ai/mcp/servers/g8rwy0077w\"\u003e\n  \u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/g8rwy0077w/badge\" alt=\"Server Make MCP server\" /\u003e\n\u003c/a\u003e\n\n## Overview\n\nThe server exposes make functionality through the Model Context Protocol, allowing LLMs like Claude to:\n- Run make targets safely with output capture\n- Understand and navigate build processes\n- Help with development tasks\n- Handle errors appropriately\n- Respect working directory context\n\nMCP Server Make works with any valid Makefile - you can use the included opinionated Makefile or your own custom build scripts.\n\n## Quick Start\n\n### Installation\n\nUsing `uv` (recommended):\n```bash\nuv pip install mcp-server-make\n```\n\nUsing pip:\n```bash\npip install mcp-server-make\n```\n\n### Basic Usage\n```bash\n# Run with default Makefile in current directory\nuvx mcp-server-make\n\n# Run with specific Makefile and working directory\nuvx mcp-server-make --make-path /path/to/Makefile --working-dir /path/to/working/dir\n```\n\n### MCP Client Configuration \n\nTo use with Claude Desktop, add to your Claude configuration (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"make\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"mcp-server-make\",\n        \"--make-path\", \"/absolute/path/to/Makefile\",\n        \"--working-dir\", \"/absolute/path/to/working/dir\"\n      ]\n    }\n  }\n}\n```\n\n## Documentation\n\nFor detailed information about using MCP Server Make, please see our documentation:\n\n- [User Guide](docs/user_guide.md) - Complete guide to installation, configuration, and usage\n- [Custom Makefiles](docs/custom_makefiles.md) - Creating effective Makefiles for use with MCP Server Make\n\n## Enhancing Development Workflows\n\nThis server enables powerful development workflows by giving LLMs direct access to make functionality:\n\n### For Developers\n\n1. **Automated Assistance**\n   - Let Claude run and interpret test results \n   - Get build system suggestions and improvements\n   - Automate repetitive development tasks\n\n2. **Project Management**\n   - Let Claude handle dependency updates\n   - Automate release processes\n   - Maintain consistent code quality\n\n### Working with Make Targets\n\nMCP Server Make does not automatically discover available targets in your Makefile. To effectively use it with Claude:\n\n1. **Start with `make help`**: Most well-designed Makefiles include a help target\n\n   ```\n   Human: Please run make help to see what commands are available.\n   ```\n\n2. **Tell Claude about your targets**: Explicitly mention available targets and their purpose\n\n   ```\n   Human: Our project has these make targets: test, lint, format, build, and clean.\n   ```\n\n3. **Use standard conventions**: Common targets that many Makefiles include:\n\n   - `make test` - Run tests\n   - `make lint` - Check code quality \n   - `make format` - Format code\n   - `make build` - Build the project\n   - `make clean` - Clean build artifacts\n\nThe repository includes an opinionated Makefile with additional utility targets - see the [User Guide](docs/user_guide.md) for details on these extended capabilities or for creating your own custom targets.\n\n\u003e **Note**: Claude doesn't remember available targets between conversations. You'll need to introduce them at the start of each conversation.\n\n## Example Integration\n\nHere's how Claude can help with development tasks:\n\n```\nHuman: Can you run our test suite and format any code that needs it?\n\nClaude: I'll help run the tests and format the code:\n\n1. First, let's format the code:\n[Calling make tool with args {\"target\": \"format\"}]\n2 files reformatted, 3 files left unchanged\n\n2. Now let's run the tests:\n[Calling make tool with args {\"target\": \"test\"}]\nRunning tests...\n4 passed, 0 failed\n\nAll formatting and tests completed successfully. The code is now properly formatted and all tests are passing.\n```\n\n## Available Tools\n\nThe server exposes a single tool:\n\n- `make` - Run a make target from the Makefile\n    - `target` (string, required): Target name to execute\n\n## Contributing\n\nWe welcome contributions to improve mcp-server-make! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for detailed instructions on setting up your development environment, using the project tools, and submitting changes.\n\n## License\n\nMIT License - see LICENSE file for details","funding_links":[],"categories":["🤖 AI/ML","Developer Tools","Task and Project Management"],"sub_categories":["How to Submit"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwrale%2Fmcp-server-make","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwrale%2Fmcp-server-make","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwrale%2Fmcp-server-make/lists"}