{"id":49336162,"url":"https://github.com/igapyon/mikuproject-mcp","last_synced_at":"2026-04-27T01:01:31.714Z","repository":{"id":354014466,"uuid":"1221703771","full_name":"igapyon/mikuproject-mcp","owner":"igapyon","description":"mikuproject MCP style","archived":false,"fork":false,"pushed_at":"2026-04-26T17:38:24.000Z","size":120,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"devel","last_synced_at":"2026-04-26T19:21:51.008Z","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":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/igapyon.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-26T15:18:09.000Z","updated_at":"2026-04-26T17:38:29.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/igapyon/mikuproject-mcp","commit_stats":null,"previous_names":["igapyon/mikuproject-mcp"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/igapyon/mikuproject-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igapyon%2Fmikuproject-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igapyon%2Fmikuproject-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igapyon%2Fmikuproject-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igapyon%2Fmikuproject-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/igapyon","download_url":"https://codeload.github.com/igapyon/mikuproject-mcp/tar.gz/refs/heads/devel","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igapyon%2Fmikuproject-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32318417,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"ssl_error","status_checked_at":"2026-04-26T23:26:25.802Z","response_time":129,"last_error":"SSL_read: 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":[],"created_at":"2026-04-27T01:01:30.984Z","updated_at":"2026-04-27T01:01:31.690Z","avatar_url":"https://github.com/igapyon.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mikuproject-mcp\n\n`mikuproject-mcp` is a local MCP server adapter for `mikuproject`.\n\nIt exposes `mikuproject` operations to MCP clients as tools, resources, and\nprompts. The server is intended for local stdio use first. It does not call\nexternal AI services, does not start a network listener, and does not replace\nthe upstream `mikuproject` product logic.\n\n## Status\n\nThis repository is currently a Node.js / TypeScript MCP server implementation.\nThe Node package metadata is prepared for a future public package release, but\nthe current validation path is still to build and run it from a local checkout.\n\n## Requirements\n\n- Node.js 20 or later\n- npm\n- Bundled or configured `mikuproject` runtime artifacts\n\nThe checked-in runtime artifacts under `runtime/` are used by the MCP adapter\nfor local execution.\n\n## Build\n\n```sh\nnpm install\nnpm run build\n```\n\nThe MCP server entrypoint after build is:\n\n```text\npackages/node/dist/index.js\n```\n\nThe package name prepared for the Node release is:\n\n```text\n@igapyon/mikuproject-mcp-node\n```\n\n## MCP Client Configuration\n\nUse the built stdio entrypoint from your MCP client configuration.\n\nExample:\n\n```json\n{\n  \"mcpServers\": {\n    \"mikuproject\": {\n      \"command\": \"node\",\n      \"args\": [\"packages/node/dist/index.js\"]\n    }\n  }\n}\n```\n\nIf your MCP client runs from a different working directory, use paths that are\nvalid for that client environment.\n\n## Release Tarball Usage\n\nGitHub Releases may provide an npm package tarball asset named like:\n\n```text\nigapyon-mikuproject-mcp-node-0.1.0.tgz\n```\n\nAfter downloading the tarball, install it globally:\n\n```sh\nnpm install -g ./igapyon-mikuproject-mcp-node-0.1.0.tgz\n```\n\nThen configure your MCP client to run the installed command:\n\n```json\n{\n  \"mcpServers\": {\n    \"mikuproject\": {\n      \"command\": \"mikuproject-mcp\"\n    }\n  }\n}\n```\n\nYou can also run the release tarball directly with `npm exec` without a global\ninstall. Replace the version and URL with the release asset you want to use:\n\n```sh\nnpm exec --yes --package=https://github.com/igapyon/mikuproject-mcp/releases/download/v0.1.0/igapyon-mikuproject-mcp-node-0.1.0.tgz -- mikuproject-mcp\n```\n\nExample MCP client configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"mikuproject\": {\n      \"command\": \"npm\",\n      \"args\": [\n        \"exec\",\n        \"--yes\",\n        \"--package=https://github.com/igapyon/mikuproject-mcp/releases/download/v0.1.0/igapyon-mikuproject-mcp-node-0.1.0.tgz\",\n        \"--\",\n        \"mikuproject-mcp\"\n      ]\n    }\n  }\n}\n```\n\n## Runtime Configuration\n\nBy default, runtime artifacts are resolved from `runtime/`.\n\nYou can override them with environment variables:\n\n```sh\nMIKUPROJECT_MCP_RUNTIME_NODE=/path/to/mikuproject.mjs\nMIKUPROJECT_MCP_WORKSPACE=/path/to/workspace\n```\n\n`MIKUPROJECT_MCP_WORKSPACE` controls where generated state, projections,\nexports, reports, summaries, and diagnostics are written. If it is not set, the\nserver uses `workplace/` under this repository.\n\n## Tools\n\nThe server exposes product-prefixed tools derived from the upstream CLI command\ntree.\n\nCore state and AI workflow tools:\n\n- `mikuproject.ai_spec`\n- `mikuproject.ai_detect_kind`\n- `mikuproject.state_from_draft`\n- `mikuproject.ai_export_project_overview`\n- `mikuproject.ai_export_task_edit`\n- `mikuproject.ai_export_phase_detail`\n- `mikuproject.ai_validate_patch`\n- `mikuproject.state_apply_patch`\n- `mikuproject.state_diff`\n- `mikuproject.state_summarize`\n\nImport, export, and report tools:\n\n- `mikuproject.export_workbook_json`\n- `mikuproject.export_xml`\n- `mikuproject.export_xlsx`\n- `mikuproject.import_xlsx`\n- `mikuproject.report_wbs_markdown`\n- `mikuproject.report_mermaid`\n\n## Resources\n\nCommon resource URIs include:\n\n- `mikuproject://spec/ai-json`\n- `mikuproject://state/current`\n- `mikuproject://state/{name}`\n- `mikuproject://export/workbook-json`\n- `mikuproject://export/project-xml`\n- `mikuproject://export/project-xlsx`\n- `mikuproject://report/wbs-markdown`\n- `mikuproject://report/mermaid`\n- `mikuproject://summary/{operationId}`\n- `mikuproject://diagnostics/{operationId}`\n\nTool results include generated artifact paths and, where applicable,\nproduct-specific resource URIs.\n\n## Prompts\n\nThe server provides small product-specific prompts:\n\n- `mikuproject.create_project_draft`\n- `mikuproject.revise_state_with_patch`\n- `mikuproject.review_artifact_diagnostics`\n\nPrompt text refers to the AI specification resource instead of duplicating the\nfull product specification.\n\n## Diagnostics and Outputs\n\nTool results are JSON text results with:\n\n- `ok`\n- `operation`\n- `operationId`\n- `diagnostics`\n- generated artifact references\n\nOperation summaries and diagnostics are saved under the workspace and can be\nread through:\n\n- `mikuproject://summary/{operationId}`\n- `mikuproject://diagnostics/{operationId}`\n\n## Security Notes\n\nThis server is intended for trusted local use. It invokes local runtime\nartifacts and reads or writes local files based on tool arguments and workspace\nconfiguration.\n\nDo not configure it with untrusted runtime artifacts or expose it as a hosted\nnetwork service without a separate design for authentication, workspace\nisolation, upload handling, storage policy, cleanup, audit, and runtime\nisolation.\n\n## Developer Documentation\n\nDeveloper-facing repository layout, implementation order, and contract notes are\nin `docs/development.md` and `docs/miku-soft-50-mcp-design-v20260427.md`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Figapyon%2Fmikuproject-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Figapyon%2Fmikuproject-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Figapyon%2Fmikuproject-mcp/lists"}