Tools MCP Server

An MCP (Model Context Protocol) server that exposes a collection of utility tools for AI agents. This modular server allows agents to perform complex operations through well-defined tool interfaces.

Features

Markdown Collection

• ADF to Markdown: Convert Atlassian Document Format (ADF) to Extended Markdown
• Markdown to ADF: Convert Extended Markdown to Atlassian Document Format
• Table Formatting: Format tables with aligned columns for human readability
• TOC Management: Generate and refresh table of contents based on document headings

Supports all ADF elements including panels, tables, media, mentions, code blocks, and more.

Installation

npm install
npm run build

Claude Desktop Setup

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "toolkit": {
      "command": "node",
      "args": ["/absolute/path/to/tools-mcp-server/build/index.js"]
    }
  }
}

Important: Use absolute paths, not relative paths.

After updating the configuration, fully quit Claude Desktop (Cmd+Q on macOS) and reopen it.

Claude Code Setup

Global Configuration (recommended)

Edit ~/.claude.json and add the server under the mcpServers key. This makes the server available in all projects without per-project approval prompts:

{
  "mcpServers": {
    "toolkit": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/tools-mcp-server/build/index.js"]
    }
  }
}

Project Configuration

Alternatively, add a .mcp.json file to your project root for project-specific access:

{
  "mcpServers": {
    "toolkit": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/tools-mcp-server/build/index.js"]
    }
  }
}

After adding the config, restart Claude Code (exit then claude).

Available Tools

Markdown Collection

| Tool | Description | Parameters | | -------------------------- | ------------------------------------------------- | ------------------------------------------------------------------- | | markdown_adf_to_markdown | Convert ADF JSON to Extended Markdown | adf (ADF document object) | | markdown_markdown_to_adf | Convert Extended Markdown to ADF JSON | markdown (string) | | markdown_format_tables | Format tables with aligned columns | markdown (string) | | markdown_refresh_toc | Refresh existing TOC to match current headings | markdown (string), minLevel?, maxLevel? | | markdown_generate_toc | Generate TOC from headings (without inserting) | markdown (string), minLevel?, maxLevel? | | markdown_insert_toc | Replace /toc markers with generated TOC | markdown (string), minLevel?, maxLevel? | | markdown_format | Combined formatting (tables + /toc + TOC refresh) | markdown (string), formatTables? (bool), processTOC? (bool) |

Usage Examples

Once configured, you can ask Claude:

• "Convert this Confluence ADF to markdown"
• "Transform this markdown into ADF format for Jira"
• "Parse this ADF document and give me the markdown equivalent"
• "Format the tables in this markdown file"
• "Refresh the table of contents"
• "Generate a TOC for this document"

Example: ADF to Markdown

{
  "name": "markdown_adf_to_markdown",
  "arguments": {
    "adf": {
      "type": "doc",
      "version": 1,
      "content": [
        {
          "type": "paragraph",
          "content": [
            { "type": "text", "text": "Hello " },
            { "type": "text", "text": "World", "marks": [{ "type": "strong" }] }
          ]
        }
      ]
    }
  }
}

Returns: Hello World

Example: Markdown to ADF

{
  "name": "markdown_markdown_to_adf",
  "arguments": {
    "markdown": "# Heading\n\nThis is a **bold** statement."
  }
}

Returns a complete ADF document structure.

Example: Format Tables

Input: ``markdown | Name | Age | City | |---|---|---| | Alice | 30 | New York | | Bob | 25 | Los Angeles | ``

Output: ``markdown | Name | Age | City | | ----- | --- | ----------- | | Alice | 30 | New York | | Bob | 25 | Los Angeles | ``

Example: Generate TOC

Input document with headings: ```markdown

Main Title

Section 1

Subsection 1.1

Section 2

Generated TOC:

• Main Title
• Section 1
• Subsection 1.1
• Section 2

### Example: Insert TOC with /toc Marker

Input:

My Document

/toc

Introduction

Content here...

Conclusion

Final thoughts. ```

Output: ```markdown

My Document

• My Document
• Introduction
• Conclusion

Introduction

Content here...

Conclusion

Final thoughts. ```

Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run the server (for testing)
npm start

# Format code
npm run format

# Lint code
npm run lint

Adding New Tool Collections

1. Create a new folder under src/tools/ (e.g., src/tools/json/)
2. Define your tools array and handler function following the markdown pattern
3. Export tools array and handleTool function
4. Import and register in src/index.ts

Testing with MCP Inspector

npx @modelcontextprotocol/inspector node build/index.js

License

MIT