DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

2 stars 0 forks 2 watchers TypeScript MIT License
22 Open Issues Need Help Last updated: Sep 11, 2025

Open Issues Need Help

View All on GitHub

AI Summary: This issue proposes adding a new adapter for Cloudflare Pages to the `DeployTargetAdapter` interface. The goal is to enable deployment to Cloudflare Pages by emitting the necessary configuration files like `wrangler.toml` and potentially `_routes.json`. The scope is limited to medium depth, avoiding complex API calls or token management, and focusing on common SSG frameworks.

Complexity: 3/5
enhancement help wanted community area/deploy-target

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript

AI Summary: This issue proposes adding a Netlify adapter to the project, implementing the `DeployTargetAdapter` interface. The adapter will generate a `netlify.toml` file for common SSGs and provide a CLI command for deployment, without requiring complex Netlify API interactions.

Complexity: 3/5
enhancement help wanted community area/deploy-target

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript

AI Summary: This issue proposes automating the merging of Dependabot pull requests for safe dependency updates. It aims to automatically merge patch-only bumps that don't introduce API changes and pass all tests, while requiring manual review for minor or major version bumps. A new GitHub Actions workflow will be implemented to manage this automation.

Complexity: 3/5
enhancement help wanted ci/cd dependencies area/dx

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript

AI Summary: This issue proposes adding hyperlinks to three specific how-to guides to improve their usefulness and discoverability. The solution involves incorporating internal and external links to related documentation, tutorials, resources, and example code. The goal is to ensure each guide has 3-5 contextually appropriate, working hyperlinks.

Complexity: 1/5
documentation good first issue

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript

AI Summary: This issue proposes adding hyperlinks to several how-to guides to improve their usefulness and discoverability. The solution involves adding 3-5 contextually appropriate internal and external links to each affected file, ensuring they pass a link checker and adhere to conventional commit standards.

Complexity: 1/5
documentation good first issue

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript

AI Summary: This issue addresses broken links in the project's documentation. The URL `https://github.com/tosin2013/documcp/issues` is returning 406 errors and needs to be replaced with a functional URL for either creating new issues or browsing existing ones. The fix involves updating five specific files within the documentation directory.

Complexity: 1/5
documentation good first issue

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript

AI Summary: This issue addresses broken links within the project's documentation. The URL `https://github.com/tosin2013/documcp/issues` is no longer valid and needs to be replaced with either a link to create new issues or a link to browse existing ones across five specified markdown files. The fix is estimated to take 15 minutes and is labeled as a 'good first issue'.

Complexity: 1/5
documentation good first issue

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript

AI Summary: This issue proposes to modify the CI pipeline to skip commitlint validation for specific 'Initial plan' bootstrap commits generated by the Copilot Coding Agent. This is necessary because these commits have a non-conventional format that incorrectly triggers commitlint errors, blocking future Copilot-related PRs. The goal is to ignore these specific commits without compromising the validation of human-authored commits.

Complexity: 2/5
help wanted ci-cd area/dx

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript

AI Summary: This issue requests the addition of Astro as a supported Static Site Generator (SSG) within a project. It involves implementing detection logic, generating a configuration file, and creating a deployment workflow template specifically for Astro projects. The goal is to enable seamless integration and deployment of Astro sites.

Complexity: 3/5
enhancement help wanted area/ssg-adapter

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript

AI Summary: This issue proposes adding a new SSG adapter for VitePress to the project. The goal is to mirror the functionality of the existing Astro adapter (C3), enabling detection of VitePress projects, generating necessary configuration files, and creating a deployment workflow for platforms like GitHub Pages. This will enhance support for Vue and TypeScript-heavy projects.

Complexity: 3/5
enhancement help wanted area/ssg-adapter

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript

AI Summary: This issue proposes defining a new `DeployTargetAdapter` interface to support various deployment targets beyond GitHub Pages. It also includes the implementation of the Vercel adapter as the first non-GitHub Pages target, along with necessary registry updates and tests. This work is foundational for future integrations with Netlify and Cloudflare Pages.

Complexity: 3/5
enhancement help wanted priority/high area/deploy-target

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript

AI Summary: This issue proposes adding a standalone command-line interface (CLI) mode to the documcp package. This will allow users to run commands like `documcp analyze`, `documcp recommend`, and `documcp deploy` directly on their repositories without needing to run an MCP server. The CLI will reuse existing tool handlers to avoid code duplication.

Complexity: 3/5
enhancement help wanted area/dx area/cli

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript

AI Summary: This issue proposes creating a GitHub App to integrate DocuMCP's drift detection into the repository workflow. The app will trigger on push and pull request events, comment on PRs with drift findings categorized by severity, and open issues for significant drift on the default branch, leveraging an existing snapshot system.

Complexity: 3/5
enhancement help wanted community area/phase-3

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript

AI Summary: This issue proposes the creation of a VS Code extension to integrate DocuMCP tools into the IDE. The extension will expose key DocuMCP functionalities as commands and a sidebar view, communicating with a local DocuMCP server via standard input/output. The goal is to improve developer experience by making these tools readily accessible within VS Code.

Complexity: 3/5
enhancement help wanted community area/dx

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript

AI Summary: This issue proposes adding a new Docker Compose recipe for a "demo mode" to simplify trying out the DocuMCP tool. This mode will automatically set up a sample repository, run analysis and recommendation commands, and serve the generated Docusaurus site, significantly lowering the barrier to entry for evaluation.

Complexity: 3/5
enhancement good first issue community area/dx

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript

AI Summary: This issue proposes to significantly restructure the `CONTRIBUTING.md` file to be more user-friendly. It aims to create role-based contribution paths, guiding users on how to contribute based on their interests (e.g., fixing bugs, adding adapters, writing docs). Each path will include links to relevant examples and issue labels.

Complexity: 3/5
documentation good first issue community area/dx

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript

AI Summary: This issue requires a documentation quality audit using specific validation scripts against the `docs/` directory. The goal is to identify areas falling below an 85% quality bar and create follow-up issues for each category needing improvement. The audit report will be committed to a specific markdown file, and link checks must also pass.

Complexity: 2/5
documentation good first issue quality

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript

AI Summary: This issue proposes expanding the existing performance benchmark suite to handle larger, more complex repositories. The goal is to create new benchmark fixtures for repositories with 100, 1k, and 5k files, and to integrate these benchmarks into the CI pipeline. The results will be published as artifacts and a summary in PR comments, including regression detection.

Complexity: 3/5
help wanted testing performance area/dx

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript

AI Summary: This issue proposes building a static HTML dashboard within a Docusaurus site to display key release metrics like install success rate, time-to-publish, coverage trend, and CI flake rate. The data will be pulled from GitHub API and the npm registry, refreshed nightly via a GitHub Action, and rendered as pre-rendered SVGs or static JSON with a charting library.

Complexity: 3/5
enhancement help wanted release area/dx

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript

AI Summary: This issue proposes creating a deterministic script to generate enhanced release notes from conventional commit metadata. The script will group commits by type, link to related ADRs and PRs, display test coverage deltas, and summarize dependency bumps, all without using an LLM. It needs to be integrated into the existing release workflow.

Complexity: 3/5
enhancement good first issue release area/dx

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript
documentation good first issue templates community

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript
documentation enhancement help wanted good first issue

DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.

TypeScript