{
  "markdown": "\n# mcp-docs-tools\n\nDocumentation generation tools for AI agents, served via the Model Context Protocol (MCP).\n\n## Overview\n\n`mcp-docs-tools` provides five specialized documentation tools accessible through MCP:\n\n| Tool | Description |\n|------|-------------|\n| `generate_jsdoc` | Generate JSDoc/TSDoc comments from function signatures |\n| `analyze_readme` | Analyze README completeness and suggest improvements |\n| `generate_changelog` | Generate CHANGELOG entries from commit messages |\n| `generate_api_docs` | Generate REST API documentation from endpoint definitions |\n| `analyze_code_comments` | Analyze comment coverage, find TODOs, detect undocumented functions |\n\n## Installation\n\n```bash\nnpm install\nnpm run build\n```\n\n## Usage\n\n### As an MCP Server\n\nAdd to your MCP client configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"docs-tools\": {\n      \"command\": \"node\",\n      \"args\": [\"path/to/mcp-docs-tools/dist/index.js\"]\n    }\n  }\n}\n```\n\n### Tools\n\n#### generate_jsdoc\n\nParses a function signature and generates JSDoc/TSDoc with `@param`, `@returns`, `@throws`, and `@example` tags.\n\n**Parameters:**\n- `functionSignature` (string, required) - The function signature to document\n- `description` (string, optional) - Description of the function\n- `includeExample` (boolean, optional, default: true) - Whether to include an `@example` tag\n\n#### analyze_readme\n\nAnalyzes README content for required sections (Installation, Usage, License, etc.), rates completeness from 0-100, and suggests missing sections.\n\n**Parameters:**\n- `content` (string, required) - Full text content of the README file\n\n#### generate_changelog\n\nGenerates CHANGELOG entries from git-style commit messages following the Keep a Changelog format. Categorizes commits as Added, Changed, Fixed, Removed, Deprecated, or Security.\n\n**Parameters:**\n- `versions` (array, required) - Array of `{ version, date, commits }` objects\n- `projectName` (string, optional) - Project name for the header\n\n#### generate_api_docs\n\nGenerates REST API documentation in Markdown from endpoint descriptions including method, URL, parameters, request/response examples, and status codes.\n\n**Parameters:**\n- `apiTitle` (string, required) - Title for the API documentation\n- `baseUrl` (string, optional) - Base URL for the API\n- `apiDescription` (string, optional) - General API description\n- `endpoints` (array, required) - Array of endpoint definitions\n\n#### analyze_code_comments\n\nAnalyzes source code comment coverage: computes comment-to-code ratio, finds TODO/FIXME/HACK markers, detects functions without documentation, and suggests where docs are needed.\n\n**Parameters:**\n- `code` (string, required) - Source code to analyze\n- `language` (string, optional, default: \"typescript\") - Programming language\n\n## Configuration\n\nNo additional configuration required. The server runs over stdio.\n\n## License\n\nMIT\n",
  "bytes": 2860,
  "sha": "23a1e48b6f9277a2098eca10a432c37cdfe7f2e87422727be68ec1d1bdf80e25",
  "repo_slug": "rog0x/mcp-docs-tools",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_rog0x_docs_76f4a640/readme"
}