{"id":29646227,"url":"https://github.com/zig-wasm/zig-mcp","last_synced_at":"2026-01-30T06:36:07.528Z","repository":{"id":298634750,"uuid":"999700366","full_name":"zig-wasm/zig-mcp","owner":"zig-wasm","description":"Model Context Protocol (MCP) server that provides up-to-date documentation for the Zig programming language standard library and builtin functions","archived":false,"fork":false,"pushed_at":"2025-09-10T22:32:26.000Z","size":361,"stargazers_count":126,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-24T09:51:26.715Z","etag":null,"topics":["mcp","modelcontextprotocol","zig","zig-std"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/zig-wasm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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":"2025-06-10T16:46:43.000Z","updated_at":"2026-01-21T03:09:13.000Z","dependencies_parsed_at":"2025-06-12T04:41:32.065Z","dependency_job_id":"fa2bbc1c-d646-4c39-b238-bba53bbeb2e4","html_url":"https://github.com/zig-wasm/zig-mcp","commit_stats":null,"previous_names":["afirium/zig-docs-mcp","zig-wasm/zig-docs-mcp","zig-wasm/zig-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zig-wasm/zig-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zig-wasm%2Fzig-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zig-wasm%2Fzig-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zig-wasm%2Fzig-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zig-wasm%2Fzig-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zig-wasm","download_url":"https://codeload.github.com/zig-wasm/zig-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zig-wasm%2Fzig-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28906668,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-30T04:02:34.702Z","status":"ssl_error","status_checked_at":"2026-01-30T04:02:33.562Z","response_time":66,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["mcp","modelcontextprotocol","zig","zig-std"],"created_at":"2025-07-22T02:07:49.152Z","updated_at":"2026-01-30T06:36:07.513Z","avatar_url":"https://github.com/zig-wasm.png","language":"TypeScript","readme":"# Zig Docs MCP\n\nModel Context Protocol (MCP) server that provides up-to-date documentation for the Zig programming language standard library and builtin functions.\n\nIt uses the same approach as Zig's official autodoc (ziglang.org) by reading STD lib source files directly through a WASM module. However instead of returning HTML, it outputs Markdown which significantly reduces token usage.\n\nBy default, the server uses your locally installed Zig compiler to serve documentation, ensuring you always get docs that match your actual Zig version. It can also fetch documentation from ziglang.org if needed.\n\n\u003e [!TIP]\n\u003e Add `use zigdocs` to your prompt if you want to explicitly instruct the LLM to use Zig docs tools. Otherwise, LLM will automatically decide when to utilize MCP tools based on the context of your questions.\n\n\u003cp align=\"center\" width=\"100%\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/zig-wasm/.github/refs/heads/main/static/readme_mcp_1.gif\" width=\"49%\" /\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/zig-wasm/.github/refs/heads/main/static/readme_mcp_2.gif\" width=\"49%\" /\u003e\n\u003c/p\u003e\n\n## Tools\n\n- **`list_builtin_functions`** - Lists all available Zig builtin functions. Builtin functions are provided by the compiler and are prefixed with '@'. The comptime keyword on a parameter means that the parameter must be known at compile time. Use this to discover what functions are available, then use 'get_builtin_function' to get detailed documentation.\n- **`get_builtin_function`** - Search for Zig builtin functions by name and get their documentation, signatures, and usage information. Returns all matching functions ranked by relevance.\n- **`search_std_lib`** - Search the Zig standard library for declarations by name. Returns a list of matching items with their fully qualified names. Use this to discover available types, functions, and constants in the standard library.\n- **`get_std_lib_item`** - Get detailed documentation for a specific standard library item by its fully qualified name (e.g., \"std.ArrayList.init\"). Returns comprehensive documentation including function signatures, parameters, errors, examples, and source code. Set `get_source_file: true` to retrieve the entire source file where the item is implemented.\n\n## Commands\n\nThe CLI provides flexible options for version control and update management:\n\n```bash\n# Start MCP server\nzig-mcp --doc-source local\n\n# Use specific Zig version from ziglang.org instead of local Zig\nzig-mcp --doc-source remote --version 0.14.1\n\n# Enable automatic daily updates\nzig-mcp --doc-source remote --update-policy daily\n\n# Update documentation without starting MCP server (only for remote)\nzig-mcp update --version 0.15.1\n\n# Start local web server to view documentation\nzig-mcp view --version 0.15.1\n```\n\n**Version options `--version`**:\n- `master` (default) - Latest development version from Zig's master branch\n- `0.14.1`, `0.14.0`, etc. - Specific Zig release versions\n\n**Update policies `--update-policy`**:\n- `manual` (default) - No automatic updates, manual control only\n- `daily` - Check for documentation updates once per day\n- `startup` - Update documentation every time the server starts\n\n**Documentation sources `--doc-source`**:\n- `local` (default) - Use your locally installed Zig compiler's documentation server (`zig std`)\n- `remote` - Download documentation from ziglang.org\n\n## Documentation Sources\n\n### Local Mode (Default)\n\nThe server automatically uses your local Zig installation to serve documentation via `zig std`. This ensures:\n- Documentation always matches your installed Zig version\n- No network requests needed for standard library docs\n- Faster response times\n\n### Remote Mode\n\nWhen using `--doc-source remote`, documentation is fetched from ziglang.org and cached in platform-specific directories:\n- Linux: `~/.cache/zig-mcp/`\n- macOS: `~/Library/Caches/zig-mcp/`\n- Windows: `%LOCALAPPDATA%\\zig-mcp\\`\n\n## Installation\n\nThe installation examples below use the local documentation source by default. In local mode, docs are served by your installed Zig via `zig std`, requiring no network and matching your actual Zig version. This is the recommended setup for most users. For downloading docs from ziglang.org instead, see Remote Documentation (Optional) below.\n\n### Claude Code\nUsing npx (Node.js)\n```bash\nclaude mcp add zig-docs -- npx -y zig-mcp@latest\n```\n\nUsing bunx (Bun)\n```bash\nclaude mcp add zig-docs -- bunx zig-mcp@latest\n```\n\n### Roo Code\n\n1. Click the **MCP** button in Roo Code\n2. Select **\"Edit Global MCP\"** or **\"Edit Project MCP\"**\n3. Add the configuration from the JSON template below\n\n### Augment Code\n\nNavigate to **Settings → MCP Servers → Add Server** and use the JSON template below.\n\n### Claude Desktop\n\nAdd the JSON configuration below to your MCP settings file.\n\n### JSON Configuration Template\n\n**Node.js:**\n```json\n{\n  \"mcpServers\": {\n    \"zig-docs\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"zig-mcp@latest\"]\n    }\n  }\n}\n```\n\n**Bun:**\n```json\n{\n  \"mcpServers\": {\n    \"zig-docs\": {\n      \"command\": \"bunx\",\n      \"args\": [\"zig-mcp@latest\"]\n    }\n  }\n}\n```\n\n### Remote Documentation (Optional)\n\nIf you prefer downloading documentation from ziglang.org instead of using your local Zig, enable remote mode explicitly and choose a version:\n\nUsing npx (Node.js)\n```bash\nclaude mcp add zig-docs -- npx -y zig-mcp@latest --doc-source remote --version master\n```\n\nUsing bunx (Bun)\n```bash\nclaude mcp add zig-docs -- bunx zig-mcp@latest --doc-source remote --version 0.14.1\n```\n\n**Node.js (remote):**\n```json\n{\n  \"mcpServers\": {\n    \"zig-docs\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"zig-mcp@latest\", \"--doc-source\", \"remote\", \"--version\", \"master\"]\n    }\n  }\n}\n```\n\n**Bun (remote):**\n```json\n{\n  \"mcpServers\": {\n    \"zig-docs\": {\n      \"command\": \"bunx\",\n      \"args\": [\"zig-mcp@latest\", \"--doc-source\", \"remote\", \"--version\", \"0.14.1\"]\n    }\n  }\n}\n```\n","funding_links":[],"categories":["📚 Projects (1974 total)","TypeScript"],"sub_categories":["MCP Servers"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzig-wasm%2Fzig-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzig-wasm%2Fzig-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzig-wasm%2Fzig-mcp/lists"}