{"id":35751406,"url":"https://github.com/pouyanafisi/project-mcp","last_synced_at":"2026-01-13T00:01:11.258Z","repository":{"id":331348590,"uuid":"1124832668","full_name":"pouyanafisi/project-mcp","owner":"pouyanafisi","description":"Intent-based MCP server for project documentation search. Maps natural language queries to the right sources automatically—no configuration needed. The standard for AI agent documentation search.","archived":false,"fork":false,"pushed_at":"2026-01-02T15:49:01.000Z","size":360,"stargazers_count":4,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-01-06T19:11:56.207Z","etag":null,"topics":["ai-agent","ai-assistant","ai-tools","anthropic","claude","cursor","documentation","documentation-search","fuzzy-search","intent-based-search","intent-mapping","markdown","mcp","mcp-server","model-context-protocol","project-documentation","project-management","search","semantic-search","zero-config"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/project-mcp","language":"JavaScript","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/pouyanafisi.png","metadata":{"files":{"readme":".github/README_TEMPLATES.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","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-29T17:34:37.000Z","updated_at":"2026-01-05T10:09:27.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/pouyanafisi/project-mcp","commit_stats":null,"previous_names":["pouyanafisi/project-mcp"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/pouyanafisi/project-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pouyanafisi%2Fproject-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pouyanafisi%2Fproject-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pouyanafisi%2Fproject-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pouyanafisi%2Fproject-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pouyanafisi","download_url":"https://codeload.github.com/pouyanafisi/project-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pouyanafisi%2Fproject-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28364791,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T23:47:38.024Z","status":"ssl_error","status_checked_at":"2026-01-12T23:45:20.975Z","response_time":98,"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":["ai-agent","ai-assistant","ai-tools","anthropic","claude","cursor","documentation","documentation-search","fuzzy-search","intent-based-search","intent-mapping","markdown","mcp","mcp-server","model-context-protocol","project-documentation","project-management","search","semantic-search","zero-config"],"created_at":"2026-01-06T20:01:02.376Z","updated_at":"2026-01-13T00:01:11.196Z","avatar_url":"https://github.com/pouyanafisi.png","language":"JavaScript","funding_links":[],"categories":["MCP Servers Directory"],"sub_categories":["Quick Submission"],"readme":"# Documentation Templates\n\nUse these templates to get started with proper project documentation structure.\n\n## `.project/index.md` Template\n\n```markdown\n# Project Knowledge Index\n\n## Contract for AI Agents\n\nWhen a user says **\"project\"**, **\"the project\"**, or **\"my project\"**, the\ncanonical sources of truth are, in order:\n\n1. **`.project/`** — Current state, plans, todos, decisions, operational truth\n2. **Root markdown files** — README.md, DEVELOPMENT.md, ARCHITECTURE.md, etc.\n3. **`docs/`** — Long-form reference documentation\n\n## Source Mappings\n\n### \"project\" / \"the project\" / \"my project\"\n\nSearches (in order):\n\n- `.project/` directory\n- Root-level markdown files (README.md, DEVELOPMENT.md, ARCHITECTURE.md, etc.)\n- `docs/` directory\n\n### \"docs\" / \"documentation\" / \"reference\"\n\nSearches only:\n\n- `docs/` directory\n\n### \"plan\" / \"todos\" / \"roadmap\" / \"status\" / \"operational\"\n\nSearches only:\n\n- `.project/` directory\n\n## Principles\n\n- **Natural language stays natural** - Users say \"project\" not \".project/\"\n- **Repo stays conventional** - Standard directory names\n- **Agents don't guess** - Explicit mappings defined here\n- **Intent over structure** - Language maps to intent, not directory names\n```\n\n## `.project/TODO.md` Template\n\n```markdown\n# TODO\n\n## In Progress\n\n- [ ] Task description\n  - [ ] Subtask 1\n  - [ ] Subtask 2\n\n## Next Up\n\n- [ ] Upcoming task\n- [ ] Another task\n\n## Blocked\n\n- [ ] Blocked task (reason: waiting on X)\n\n## Completed\n\n- [x] Completed task\n- [x] Another completed task\n```\n\n## `.project/ROADMAP.md` Template\n\n```markdown\n# Project Roadmap\n\n## Current Quarter\n\n### Phase 1: [Name] (Weeks 1-4)\n\n- Goal 1\n- Goal 2\n- Goal 3\n\n### Phase 2: [Name] (Weeks 5-8)\n\n- Goal 1\n- Goal 2\n\n## Next Quarter\n\n### Planned Features\n\n- Feature 1\n- Feature 2\n\n## Future Considerations\n\n- Long-term goal 1\n- Long-term goal 2\n```\n\n## `.project/STATUS.md` Template\n\n```markdown\n# Project Status\n\n**Last Updated:** [Date]\n\n## Current Phase\n\n[Phase Name] - [Brief description]\n\n## Health\n\n🟢 **Green** / 🟡 **Yellow** / 🔴 **Red**\n\n## Recent Changes\n\n- ✅ Completed: [What was done]\n- 🔄 In progress: [What's happening now]\n- 📋 Planned: [What's next]\n\n## Metrics\n\n- Test Coverage: X%\n- Build Status: [Passing/Failing]\n- Deployment: [Stable/Unstable]\n\n## Risks \u0026 Blockers\n\n- [Risk or blocker description]\n\n## Next Milestone\n\n[Description] by [Date]\n```\n\n## `docs/architecture/OVERVIEW.md` Template\n\n```markdown\n# System Architecture Overview\n\n## High-Level Design\n\n[Brief description of system architecture]\n\n### Components\n\n1. **Component 1** - [Description]\n2. **Component 2** - [Description]\n3. **Component 3** - [Description]\n\n### Data Flow\n```\n\n[ASCII diagram or description]\n\n```\n\n## Technology Stack\n\n- **Backend:** [Technology]\n- **Database:** [Database]\n- **Cache:** [Cache solution]\n- **Queue:** [Queue solution]\n\n## Scalability\n\n[How the system scales]\n\n## Security\n\n[Security considerations]\n```\n\n## `docs/api/ENDPOINTS.md` Template\n\n````markdown\n# API Endpoints\n\n## Authentication\n\n### POST /api/auth/login\n\n[Description]\n\n**Request:**\n\n```json\n{\n\t\"field\": \"value\"\n}\n```\n````\n\n**Response:**\n\n```json\n{\n\t\"field\": \"value\"\n}\n```\n\n**Status Codes:**\n\n- `200` - Success\n- `401` - Unauthorized\n- `400` - Bad Request\n\n````\n\n## Best Practices\n\n### Writing Good Documentation\n\n1. **Use frontmatter** for metadata:\n   ```markdown\n   ---\n   title: My Document\n   description: Brief description\n   ---\n````\n\n2. **Clear headings** - Use H1 for title, H2 for main sections\n\n3. **Code examples** - Include working examples\n\n4. **Keep it updated** - Outdated docs are worse than no docs\n\n5. **Be specific** - Avoid vague descriptions\n\n### Organizing `.project/` Files\n\n- **Keep it current** - Remove completed items, update status\n- **Be actionable** - Use clear, specific tasks\n- **Include context** - Why, not just what\n- **Regular updates** - Update at least weekly\n\n### Organizing `docs/` Files\n\n- **Comprehensive** - Cover topics fully\n- **Stable** - Don't change frequently\n- **Cross-reference** - Link related docs\n- **Examples** - Include real-world examples\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpouyanafisi%2Fproject-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpouyanafisi%2Fproject-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpouyanafisi%2Fproject-mcp/lists"}