# docs [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/rog0x/mcp-docs-tools  
**GitHub Stars:** 0  
**npm Downloads (last month):** 4537  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/docs-8

## Description
JSDoc, README, changelog generation for AI agents

## Tools
Capabilities this server exposes over MCP:

- **functionSignature**
- **description**
- **includeExample**
- **content**
- **versions**
- **projectName**
- **apiTitle**
- **baseUrl**
- **apiDescription**
- **endpoints**
- **code**
- **language**

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "docs": {
    "command": "npx",
    "args": ["-y","docs-8"]
  }
}
```

## Documentation & README


# mcp-docs-tools

Documentation generation tools for AI agents, served via the Model Context Protocol (MCP).

## Overview

`mcp-docs-tools` provides five specialized documentation tools accessible through MCP:

| Tool | Description |
|------|-------------|
| `generate_jsdoc` | Generate JSDoc/TSDoc comments from function signatures |
| `analyze_readme` | Analyze README completeness and suggest improvements |
| `generate_changelog` | Generate CHANGELOG entries from commit messages |
| `generate_api_docs` | Generate REST API documentation from endpoint definitions |
| `analyze_code_comments` | Analyze comment coverage, find TODOs, detect undocumented functions |

## Installation

```bash
npm install
npm run build
```

## Usage

### As an MCP Server

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "docs-tools": {
      "command": "node",
      "args": ["path/to/mcp-docs-tools/dist/index.js"]
    }
  }
}
```

### Tools

#### generate_jsdoc

Parses a function signature and generates JSDoc/TSDoc with `@param`, `@returns`, `@throws`, and `@example` tags.

**Parameters:**
- `functionSignature` (string, required) - The function signature to document
- `description` (string, optional) - Description of the function
- `includeExample` (boolean, optional, default: true) - Whether to include an `@example` tag

#### analyze_readme

Analyzes README content for required sections (Installation, Usage, License, etc.), rates completeness from 0-100, and suggests missing sections.

**Parameters:**
- `content` (string, required) - Full text content of the README file

#### generate_changelog

Generates CHANGELOG entries from git-style commit messages following the Keep a Changelog format. Categorizes commits as Added, Changed, Fixed, Removed, Deprecated, or Security.

**Parameters:**
- `versions` (array, required) - Array of `{ version, date, commits }` objects
- `projectName` (string, optional) - Project name for the header

#### generate_api_docs

Generates REST API documentation in Markdown from endpoint descriptions including method, URL, parameters, request/response examples, and status codes.

**Parameters:**
- `apiTitle` (string, required) - Title for the API documentation
- `baseUrl` (string, optional) - Base URL for the API
- `apiDescription` (string, optional) - General API description
- `endpoints` (array, required) - Array of endpoint definitions

#### analyze_code_comments

Analyzes source code comment coverage: computes comment-to-code ratio, finds TODO/FIXME/HACK markers, detects functions without documentation, and suggests where docs are needed.

**Parameters:**
- `code` (string, required) - Source code to analyze
- `language` (string, optional, default: "typescript") - Programming language

## Configuration

No additional configuration required. The server runs over stdio.

## License

MIT