{"id":28958845,"url":"https://github.com/jasonjgardner/blockbench-mcp-plugin","last_synced_at":"2025-06-23T23:32:51.667Z","repository":{"id":295060338,"uuid":"985507503","full_name":"jasonjgardner/blockbench-mcp-plugin","owner":"jasonjgardner","description":"Adds MCP server to Blockbench","archived":false,"fork":false,"pushed_at":"2025-06-07T20:45:13.000Z","size":98,"stargazers_count":2,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-20T04:08:13.596Z","etag":null,"topics":["blockbench","mcp-server"],"latest_commit_sha":null,"homepage":"https://jasonjgardner.github.io/blockbench-mcp-plugin/mcp.js","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jasonjgardner.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-05-17T23:03:57.000Z","updated_at":"2025-06-09T18:34:01.000Z","dependencies_parsed_at":"2025-05-23T13:29:47.487Z","dependency_job_id":"a76daf20-98bc-467a-b5a3-3935b06df110","html_url":"https://github.com/jasonjgardner/blockbench-mcp-plugin","commit_stats":null,"previous_names":["jasonjgardner/blockbench-mcp-plugin"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/jasonjgardner/blockbench-mcp-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasonjgardner%2Fblockbench-mcp-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasonjgardner%2Fblockbench-mcp-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasonjgardner%2Fblockbench-mcp-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasonjgardner%2Fblockbench-mcp-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jasonjgardner","download_url":"https://codeload.github.com/jasonjgardner/blockbench-mcp-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasonjgardner%2Fblockbench-mcp-plugin/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261575695,"owners_count":23179555,"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":["blockbench","mcp-server"],"created_at":"2025-06-23T23:31:41.006Z","updated_at":"2025-06-23T23:32:51.655Z","avatar_url":"https://github.com/jasonjgardner.png","language":"TypeScript","funding_links":[],"categories":["📦 Other"],"sub_categories":[],"readme":"# Blockbench MCP\n\nhttps://github.com/user-attachments/assets/ab1b7e63-b6f0-4d5b-85ab-79d328de31db\n\n## Plugin Installation\n\nOpen Blockbench, go to File \u003e Plugins and click the \"Load Plugin from URL\" and paste in this URL:\n\n\n__[https://jasonjgardner.github.io/blockbench-mcp-plugin/mcp.js](https://jasonjgardner.github.io/blockbench-mcp-plugin/mcp.js)__\n\n\n## Model Context Protocol Server\nConfigure experimental MCP server under Blockbench settings: __Settings__ \u003e __General__ \u003e __MCP Server Port__ and __MCP Server Endpoint__\n\nThe following examples use the default values of `:3000/mcp`\n\n### Installation\n\n#### Claude Desktop\n\n__`claude_desktop_config.json`__\n\n```json\n{\n  \"mcpServers\": {\n    \"blockbench\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"mcp-remote\",\n        \"http://localhost:3000/mcp\"\n      ]\n    }\n  }\n}\n```\n\n#### VS Code\n\n__`.vscode/mcp.json`__\n\n```json\n{\n    \"servers\": {\n        \"blockbench\": {\n            \"url\": \"http://localhost:3000/mcp\"\n        },\n    }\n}\n```\n\n## Plugin Development\n\n### Contribution\n\nAddition or modification of tools, prompts and resources is welcome. It should be a relatively-familiar process for Blockbench contributor/plugin authors; however, does require TypeScript compilation. [Bun is recommended for the task.](https://bun.sh/)\n### Dev Setup\n\n```sh\nbunx @modelcontextprotocol/inspector\n```\nThe Streamable HTTP transport URL defaults to __http://localhost:3000/mcp__\n\n```sh\ncd ./src/mcp\nbun install\nbun run build\n```\n\n#### Adding Tools\n\n```typescript\n// ./src/mcp/server/tools.ts\nimport { z } from \"zod\";\nimport { createTool } from \"@/lib/factories\";\n\ncreateTool({\n    name: \"tool_name\",\n    description: \"Tool description for the AI agent\"\n    parameters: z.object({\n        // Parameters required to execute your tool:\n        examples: z.array({\n            // Zod schema to collect arguments.\n            // Does not have to be 1:1 with Blockbench\n        })\n    }),\n    async execute({ examples }, { reportProgress }) {\n        return JSON.stringify(examples.map((example, idx) =\u003e {\n            reportProgress({\n                progress: idx,\n                total: examples.length\n            });\n\n            // Do something with parameters within current context.\n            // Has access to Blockbench, electron, FastMCP, and other API\n            // Return stringified results to report to AI agent context.\n\n            return myExampleTransformFunction(example);\n        }));\n    }\n});\n```\n\n#### Adding Resources\n\nNo factory function has been created yet. Refer to [FactMCP's documentation for Resource examples](https://github.com/punkpeye/fastmcp?tab=readme-ov-file#resources).\n\nAdd resource-related code to `./src/mcp/server/resources.ts`\n\n#### Adding Prompts\n\nNo factory function has been created yet. Refer to [FactMCP's documentation for Prompts examples](https://github.com/punkpeye/fastmcp?tab=readme-ov-file#prompts).\n\nAdd prompt-related code to `./src/mcp/server/prompts.ts`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjasonjgardner%2Fblockbench-mcp-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjasonjgardner%2Fblockbench-mcp-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjasonjgardner%2Fblockbench-mcp-plugin/lists"}