article

README

TranscriptionTools MCP Server

An MCP server providing intelligent transcript processing capabilities, featuring natural formatting, contextual repair, and smart summarization powered by Deep Thinking LLMs.

Available MCP Tools

This MCP server exposes four powerful tools for transcript processing:

repair_text - Analyzes and repairs transcription errors with greater than 90% confidence
get_repair_log - Retrieves detailed analysis logs from previous repairs
format_transcript - Transforms timestamped transcripts into naturally formatted text
summary_text - Generates intelligent summaries using ACE cognitive methodology

Installation

Installing via Smithery

To install Transcription Tools for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @MushroomFleet/transcriptiontools-mcp --client claude

Clone this repository:

git clone https://github.com/mushroomfleet/TranscriptionTools-MCP
cd TranscriptionTools-MCP

Install dependencies:

npm install

Build the server:

npm run build

Configure the MCP server in your MCP settings file:

{
  "mcpServers": {
    "transcription-tools": {
      "command": "node",
      "args": ["/path/to/TranscriptionTools-MCP/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Using the MCP Tools

Repairing Transcription Errors

<use_mcp_tool>
<server_name>transcription-tools</server_name>
<tool_name>repair_text</tool_name>
<arguments>
{
  "input_text": "We recieve about ten thousand dollars which is defiantly not enough.",
  "is_file_path": false
}
</arguments>
</use_mcp_tool>

Formatting Timestamped Transcripts

<use_mcp_tool>
<server_name>transcription-tools</server_name>
<tool_name>format_transcript</tool_name>
<arguments>
{
  "input_text": "/path/to/timestamped-transcript.txt",
  "is_file_path": true,
  "paragraph_gap": 8,
  "line_gap": 4
}
</arguments>
</use_mcp_tool>

Generating Summaries

<use_mcp_tool>
<server_name>transcription-tools</server_name>
<tool_name>summary_text</tool_name>
<arguments>
{
  "input_text": "Long text to summarize...",
  "is_file_path": false,
  "constraint_type": "words",
  "constraint_value": 100
}
</arguments>
</use_mcp_tool>

Retrieving Repair Logs

<use_mcp_tool>
<server_name>transcription-tools</server_name>
<tool_name>get_repair_log</tool_name>
<arguments>
{
  "session_id": "20241206143022"
}
</arguments>
</use_mcp_tool>

Core Technologies

Natural Formatting

Removes timestamps while preserving speech patterns
Applies intelligent spacing based on pause duration
Respects natural grammar and language flow
Maintains exact transcribed content

Contextual Repair

Identifies and corrects likely transcription errors
Uses semantic context for high-confidence corrections
Maintains detailed logs of all changes
90% confidence threshold for corrections
No original audio required

Smart Summarization

Creates concise summaries of processed transcripts
Supports multiple constraint types:
- Time-based (speaking duration)
- Character count
- Word count
Preserves key information and context
Maintains natural speaking rhythm

Project Structure

/
├── .gitignore         # Git ignore file
├── LICENSE            # MIT license file
├── README.md          # This documentation
├── package.json       # Package dependencies and scripts
├── tsconfig.json      # TypeScript configuration
├── build/             # Compiled JavaScript files (generated after build)
│   ├── tools/         # Compiled tool implementations
│   └── utils/         # Compiled utility functions
└── src/               # Source TypeScript files
    ├── index.ts       # MCP server entry point
    ├── tools/         # Tool implementations
    │   ├── formatting.ts
    │   ├── repair.ts
    │   └── summary.ts
    └── utils/         # Utility functions
        ├── file-handler.ts
        └── logger.ts

Configuration

You can customize the server behavior by modifying the source code directly. The key configuration parameters are found in the respective tool implementation files:

// In src/tools/formatting.ts
const paragraph_gap = 8; // seconds
const line_gap = 4;      // seconds

// In src/tools/repair.ts
const confidence_threshold = 90; // percentage

// In src/tools/summary.ts
const default_speaking_pace = 150; // words per minute

License

MIT

TranscriptionTools-MCP