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.

Related MCP server: Markdown-To-Notion

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

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:

| Name | Age | City |
|---|---|---|
| Alice | 30 | New York |
| Bob | 25 | Los Angeles |

Output:

| Name  | Age | City        |
| ----- | --- | ----------- |
| Alice | 30  | New York    |
| Bob   | 25  | Los Angeles |

Example: Generate TOC

Input document with headings:

# Main Title
## Section 1
### Subsection 1.1
## Section 2

Generated TOC:

- [Main Title](#main-title)
  - [Section 1](#section-1)
    - [Subsection 1.1](#subsection-11)
  - [Section 2](#section-2)

Example: Insert TOC with /toc Marker

Input:

# My Document

/toc

## Introduction

Content here...

## Conclusion

Final thoughts.

Output:

# My Document

- [My Document](#my-document)
  - [Introduction](#introduction)
  - [Conclusion](#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