MCP Ahrefs

# Bazel Integration This project includes Bazel build support for building and running the MCP server. ## Prerequisites 1. **Bazel**: Install Bazel following the [official installation guide](https://bazel.build/install) 2. **Python**: Ensure Python 3.12 is available 3. **Requirements**: Run `./refresh_requirements_txt.sh` to generate the requirements files needed by Bazel ## Building with Bazel ```bash # Build all targets bazel build //... # Build the MCP server specifically bazel build //mcp_ahrefs:mcp_ahrefs ``` ## Running with Bazel ```bash # Run the MCP server bazel run //mcp_ahrefs:mcp_ahrefs # Run with arguments bazel run //mcp_ahrefs:mcp_ahrefs -- --help ``` ## Project Structure The Bazel build is configured in `BUILD.bazel`: - **py_binary**: `mcp_ahrefs` - The executable MCP server - **py_library**: `mcp_ahrefs_lib` - The library containing all source files ## Dependencies Dependencies are explicitly listed in the `BUILD.bazel` file. The project includes: - Core MCP dependencies (mcp, anyio, starlette, uvicorn, click) - Utility dependencies (platformdirs, loguru, pydantic, pyyaml, python-multipart) - Admin UI dependencies (streamlit, plotly, pandas) ### Adding New Dependencies When adding new dependencies: 1. Add the dependency to `pyproject.toml` 2. Run `./refresh_requirements_txt.sh` to update the requirements files 3. Add the dependency to the `deps` list in `BUILD.bazel`: ```python deps = [ # ... existing deps ... "@mcp_mcp_ahrefs//new_package", ] ``` ### Package Name Mappings Some Python packages have different names in Bazel: | Python Package | Bazel Target | |----------------|--------------| | python-multipart | @mcp_pypi//multipart | | PyYAML | @mcp_pypi//pyyaml | ## Testing with Bazel ```bash # Run all tests bazel test //... # Run specific test targets bazel test //tests:all ``` ## Troubleshooting ### Import Errors If you encounter import errors: - Verify all dependencies are listed in both `pyproject.toml` and `BUILD.bazel` - Check that the `imports` attribute is correctly set - Ensure `refresh_requirements_txt.sh` has been run recently ### Missing Dependencies If Bazel reports missing dependencies: - Ensure the dependency is in your WORKSPACE pip_parse rule - Check for package name mappings (e.g., `python-multipart` → `multipart`) - Verify the dependency exists in the generated requirements files ### Build Cache To clean the Bazel build cache: ```bash bazel clean ``` For a full clean including the external dependencies: ```bash bazel clean --expunge ```