{"id":28766942,"url":"https://github.com/base/base-builder-mcp","last_synced_at":"2025-07-13T07:41:36.779Z","repository":{"id":287217484,"uuid":"963549374","full_name":"base/base-builder-mcp","owner":"base","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-16T18:15:54.000Z","size":87,"stargazers_count":5,"open_issues_count":1,"forks_count":9,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-06-16T19:30:18.407Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/base.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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-04-09T21:09:13.000Z","updated_at":"2025-06-16T18:15:57.000Z","dependencies_parsed_at":null,"dependency_job_id":"4ce3bdb8-faa1-4edc-818b-f081bb560426","html_url":"https://github.com/base/base-builder-mcp","commit_stats":null,"previous_names":["base/base-builder-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/base/base-builder-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/base%2Fbase-builder-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/base%2Fbase-builder-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/base%2Fbase-builder-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/base%2Fbase-builder-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/base","download_url":"https://codeload.github.com/base/base-builder-mcp/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/base%2Fbase-builder-mcp/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260360058,"owners_count":22997413,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2025-06-17T12:37:42.150Z","updated_at":"2025-07-13T07:41:36.773Z","avatar_url":"https://github.com/base.png","language":"TypeScript","funding_links":[],"categories":["📦 Other","🏗️ Build \u0026 Deployment Tools"],"sub_categories":[],"readme":"# Base Builder MCP - Alpha Release\n\nThis repository is an MCP server destined for Base Builders.\n\nIn this alpha release, the server contains an implementation of [Base Docs](https://docs.base.org) adapted for Model Context Protocol (MCP).\n\nFollow the instructions below to use it 👇\n\n## Steps to Build and Add your MCP server\n\n- Clone the repo and navigate to the directory:\n\n```bash\ngit clone https://github.com/base/base-builder-mcp\ncd base-builder-mcp\n```\n\n- Install the dependencies:\n\n```bash\nnpm install\n```\n\n- You can now add the server to Claude or Cursor (Project Only or Global):\n\n\n```bash\nnpm run setup:cursor\n```\n\n```bash\nnpm run setup:claude\n```\n\n*Note: ✅ OPENAI Key is optional but recommended. It allows the guide to be reviewed and digested by another LLM to create a json file of the guide instead of feeding raw guide text to your agent.*\n\n*Note 2: If you are facing issues with the last step (adding the server), you can check out [MCP documentation](https://modelcontextprotocol.io/quickstart/user) for Claude Desktop or [Cursor Docs](https://docs.cursor.com/context/model-context-protocol) for your Cursor IDE agent*\n\n\n## Cursor Rules (Recommended)\n\nAdd the following to your Cursor rules by going to the command palette (Cmd/Ctrl + Shift + P) and selecting \u003e Cursor Settings \u003e Rules:\n\n```js\n\u003cMCP_USE_GUIDELINE\u003e\n  \u003cINSTRUCTION\u003e\n    If the user says \"I want to build on Base\", make frequent use of the BuildOnBase MCP tool from Base-Docs MCP.\n  \u003c/INSTRUCTION\u003e\n  \u003cTOOLS\u003e\n    What is the BuildOnBase tool from Base Builder MCP?\n    It's a tool which allows you to browse the sidebar of Base Docs and find the relevant guides to Build on Base. If you run this tool and you get an error because the guide is not found, try other guides from the sidebar.\n  \u003c/TOOLS\u003e\n\u003c/MCP_USE_GUIDELINE\u003e\n```\n\n## Expected Result\n\nAfter adding Base Builder MCP to your agent, you can use it by saying \"I want to build with base\". Using that should trigger a call to the Base Builder MCP server:\n\n ![Cursor Agent](https://i.imgur.com/uSp0vOG.png)\n *Cursor agent calling Base Builder MCP*\n\n![Claude Agent](https://i.imgur.com/WNdcToq.png)\n *Claude agent calling Base Builder MCP*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbase%2Fbase-builder-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbase%2Fbase-builder-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbase%2Fbase-builder-mcp/lists"}