{"id":41840323,"url":"https://github.com/mako10k/mcp-copilot-instructions","last_synced_at":"2026-01-25T09:20:35.450Z","repository":{"id":327372171,"uuid":"1107355487","full_name":"mako10k/mcp-copilot-instructions","owner":"mako10k","description":"MCP server for context-dependent dynamic instruction generation with goal management. Solves LLM attention dispersion.","archived":false,"fork":false,"pushed_at":"2025-12-03T08:33:26.000Z","size":13717,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-06T10:34:47.465Z","etag":null,"topics":["ai","claude","context-management","github-copilot","goals","instructions","llm","mcp","model-context-protocol"],"latest_commit_sha":null,"homepage":null,"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/mako10k.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":"2025-12-01T02:47:35.000Z","updated_at":"2025-12-03T08:33:11.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mako10k/mcp-copilot-instructions","commit_stats":null,"previous_names":["mako10k/mcp-copilot-instructions"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/mako10k/mcp-copilot-instructions","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mako10k%2Fmcp-copilot-instructions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mako10k%2Fmcp-copilot-instructions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mako10k%2Fmcp-copilot-instructions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mako10k%2Fmcp-copilot-instructions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mako10k","download_url":"https://codeload.github.com/mako10k/mcp-copilot-instructions/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mako10k%2Fmcp-copilot-instructions/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28750872,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T09:00:19.176Z","status":"ssl_error","status_checked_at":"2026-01-25T09:00:04.131Z","response_time":113,"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":["ai","claude","context-management","github-copilot","goals","instructions","llm","mcp","model-context-protocol"],"created_at":"2026-01-25T09:20:34.928Z","updated_at":"2026-01-25T09:20:35.437Z","avatar_url":"https://github.com/mako10k.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mcp-copilot-instructions\n\n**Solving LLM Attention Dispersion Problem with \"Context-Dependent Dynamic Instruction Generation\"**\n\n## Challenge\nAdding extensive instructions → Massive growth → LLM attention dispersion → Important instructions become ineffective\n\n## Solution\n```\nHuge instruction database (.copilot-instructions/, Git managed)\n    ↓ Context recognition engine (MCP server)\n    ↓ Understand current state/flow from ToDo management\n    ↓ Extract only relevant instructions\n.github/copilot-instructions.md (dynamically generated)\n    ↓ Narrowed down to only necessary instructions for current context\nLLM (Focused attention)\n```\n\n## Purpose\n- **Prevent attention dispersion from instruction bloat**: Retain overall project knowledge while providing LLM with only instructions needed for \"current flow\"\n- **Context-dependent dynamic generation**: Automatically extract appropriate instructions for current phase from ToDo and task state\n- **Git-managed change history**: Manage entire instruction database with Git, utilize branching strategy, review, and rollback\n\n## Important: Terminology Definition\n\nIn this project, careful attention is required regarding who \"user\" refers to:\n\n- **Copilot (LLM)**: **Primary user** of MCP tools. Calls tools itself to manage context.\n- **Human Developer**: Actual developer using Copilot. Gives instructions to Copilot and makes final decisions.\n\nUnless specifically noted, \"user\" refers to **Copilot (LLM) itself**.\n\n## Installation\n\n### Using npx (Recommended)\n\nThe easiest way to use this MCP server is via npx:\n\n```bash\nnpx @mako10k/mcp-copilot-instructions\n```\n\n### From npm\n\n```bash\nnpm install -g @mako10k/mcp-copilot-instructions\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/mako10k/mcp-copilot-instructions.git\ncd mcp-copilot-instructions/server\nnpm install\nnpm run build\n```\n\n## Configuration\n\n### For Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"copilot-instructions\": {\n      \"command\": \"npx\",\n      \"args\": [\"@mako10k/mcp-copilot-instructions\"]\n    }\n  }\n}\n```\n\n**Config file locations:**\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n- Linux: `~/.config/Claude/claude_desktop_config.json`\n\n### For VS Code with GitHub Copilot\n\nAdd to your VS Code `settings.json`:\n\n```json\n{\n  \"github.copilot.chat.mcp.enabled\": true,\n  \"github.copilot.chat.mcp.servers\": {\n    \"copilot-instructions\": {\n      \"command\": \"npx\",\n      \"args\": [\"@mako10k/mcp-copilot-instructions\"]\n    }\n  }\n}\n```\n\n### Using Local Installation\n\nIf installed globally or from source:\n\n```json\n{\n  \"mcpServers\": {\n    \"copilot-instructions\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/mcp-copilot-instructions/server/dist/index.js\"]\n    }\n  }\n}\n```\n\n## Quick Start\n\nAfter configuration, restart your MCP client (Claude Desktop or VS Code). The server will automatically start when the client initializes.\n\n## Main Documentation\n- Design: `docs/mcp-server-design.md`\n- Operations: `docs/operation-scenarios.md`\n- Research: `research/copilot-instructions-research.md`\n- Instructions: `.github/copilot-instructions.md`\n\n## Operations Policy (Excerpt)\n- Regular review: At least once a week, immediate reflection for important changes\n- Change retention: Reflect decisions made in conversations into instructions and context\n- Conflict management: Explicitly invalidate old rules and prioritize new rules\n\n## Key Features (Phase 2 Complete)\n- ✅ **Goal Management System**: Hierarchical goal tracking with auto-advancement, never lose sight of objectives\n- ✅ **Conflict Detection**: External change detection with safe resolution\n- ✅ **History Management**: Rollback capability with 30-day retention\n- ✅ **Dynamic Generation**: Context-aware instruction filtering\n- ✅ **Feedback System**: Critical feedback tracking with hard/soft limits\n\n## Available MCP Tools\n1. **guidance**: Usage guide and current status\n2. **project_context**: CRUD operations for project context\n3. **instructions_structure**: Markdown AST operations with conflict management\n4. **change_context**: Development context switching with auto-regeneration\n5. **feedback**: Critical feedback tracking\n6. **onboarding**: Migration support for existing projects\n7. **goal_management**: Hierarchical goal tracking and progress management\n\n## Troubleshooting\n\n### Server doesn't start\n- Ensure Node.js 18+ is installed: `node --version`\n- Verify npx is available: `which npx`\n- Check MCP client logs for error messages\n\n### Tools not appearing\n- Restart MCP client completely\n- Verify configuration JSON syntax is valid\n- Check that command path is correct\n\n### Permission errors\n- On Unix systems, ensure execute permission: `chmod +x dist/index.js`\n- For global install, may need sudo: `sudo npm install -g @mako10k/mcp-copilot-instructions`\n\n## Contributing\n\nContributions are welcome! Please see:\n- Design documentation: `docs/mcp-server-design.md`\n- Development scenarios: `docs/operation-scenarios.md`\n\n## License\n\nMIT License - see LICENSE file for details\n\n## Next Development Steps\n- Integration testing and CI/CD setup\n- Performance optimization for large instruction sets\n- Enhanced analytics for instruction effectiveness\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmako10k%2Fmcp-copilot-instructions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmako10k%2Fmcp-copilot-instructions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmako10k%2Fmcp-copilot-instructions/lists"}