DeepWriter MCP Server

Official Site: DeepWriter.com

Additional Documentation: DeepWriter API Access Docs

A Model Context Protocol (MCP) server for interacting with the DeepWriter API. This server provides tools for creating, managing, and generating content for DeepWriter projects through the standardized MCP interface.

Features

• Project Management: Create, list, update, and delete projects
• Content Generation: Generate content for projects using DeepWriter's AI
• Project Details: Retrieve detailed information about projects
• MCP Integration: Seamlessly integrate with Claude and other MCP-compatible AI assistants
• Standard MCP Features: Implements MCP protocol version 2025-03-26
• Transport Support: Stdio transport for local process communication

Prerequisites

• Node.js (v17 or higher)
• npm (v6 or higher)
• DeepWriter API key
• An MCP-compatible client (e.g., Claude for Desktop)

Installation

Installing via Smithery

To install deepwriter-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @deepwriter-ai/deepwriter-mcp --client claude

Manual Installation

1. Clone the repository:

git clone https://github.com/yourusername/deepwriter-mcp.git
   cd deepwriter-mcp

2. Install dependencies:

npm install

3. Create a `.env` file in the root directory with your DeepWriter API key:

DEEPWRITER_API_KEY=your_api_key_here

4. Build the project:

npm run build

Usage

Starting the Server

Start the MCP server:

node build/index.js

The server will listen on stdin for MCP requests and respond on stdout, following the MCP stdio transport specification.

Connecting to Claude for Desktop

To use the DeepWriter MCP server with Claude for Desktop:

1. Open your Claude for Desktop configuration file:

2. Add the server configuration:

{
     "mcpServers": {
       "deepwriter": {
         "command": "node",
         "args": ["/ABSOLUTE/PATH/TO/deepwriter-mcp/build/index.js"],
         "env": {
           "DEEPWRITER_API_KEY": "your_api_key_here"
         }
       }
     }
   }

3. Restart Claude for Desktop to load the new configuration.

MCP Protocol Support

This server implements MCP protocol version 2025-03-26 with the following capabilities:

• Transport: Stdio transport for local process communication
• Tools: Full support for all DeepWriter API operations
• Logging: Structured logging with configurable levels

Available Tools

1. listProjects

Lists all projects associated with your DeepWriter account.

{
  "api_key": "your_api_key_here"
}

2. getProjectDetails

Retrieves detailed information about a specific project.

{
  "api_key": "your_api_key_here",
  "project_id": "your_project_id_here"
}

3. createProject

Creates a new project with the specified title and email.

{
  "api_key": "your_api_key_here",
  "title": "Your Project Title",
  "email": "your_email@example.com"
}

4. updateProject

Updates an existing project with the specified changes.

{
  "api_key": "your_api_key_here",
  "project_id": "your_project_id_here",
  "updates": {
    "title": "Updated Project Title",
    "prompt": "Updated project prompt",
    "author": "Updated author name",
    "email": "updated@email.com",
    "model": "Updated model name",
    "outline_text": "Updated outline",
    "style_text": "Updated style guide",
    "supplemental_info": "Updated additional information",
    "work_description": "Updated work description",
    "work_details": "Updated work details",
    "work_vision": "Updated work vision"
  }
}

5. generateWork

Generates content for a project using DeepWriter's AI.

{
  "api_key": "your_api_key_here",
  "project_id": "your_project_id_here",
  "is_default": true // Optional, defaults to true
}

6. deleteProject

Deletes a project.

{
  "api_key": "your_api_key_here",
  "project_id": "your_project_id_here"
}

Development

Project Structure

deepwriter-mcp/
├── src/
│   ├── index.ts              # Main entry point and MCP server setup
│   ├── api/
│   │   └── deepwriterClient.ts  # DeepWriter API client
│   └── tools/                # MCP tool implementations
│       ├── createProject.ts
│       ├── deleteProject.ts
│       ├── generateWork.ts
│       ├── getProjectDetails.ts
│       ├── listProjects.ts
│       └── updateProject.ts
├── build/                    # Compiled JavaScript output
├── test-deepwriter-tools.js  # Tool testing script
├── test-mcp-client.js       # MCP client testing script
└── tsconfig.json            # TypeScript configuration

Building

npm run build

This will compile the TypeScript code into JavaScript in the `build` directory.

Testing

You can test the MCP server locally using the provided test scripts:

node test-mcp-client.js

or

node test-deepwriter-tools.js

TypeScript Configuration

The project uses TypeScript with ES modules and Node16 module resolution. Key TypeScript settings:

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "Node16",
    "moduleResolution": "Node16",
    "outDir": "./build",
    "strict": true
  }
}

Troubleshooting

Common Issues

1. API Key Issues:

2. Connection Problems:

3. MCP Protocol Issues:

4. Parameter Naming:

Debugging

For detailed logs, run the server with the DEBUG environment variable:

DEBUG=deepwriter-mcp:* node build/index.js

You can also check Claude for Desktop logs at:

• macOS: `~/Library/Logs/Claude/mcp*.log`
• Windows: `%APPDATA%\Claude\logs\mcp*.log`

Contributing

We welcome contributions from the community! Here's how you can help:

Submitting Issues

1. Bug Reports

2. Feature Requests

3. Security Issues

Pull Requests

1. Before Starting

2. Development Process

3. PR Requirements

4. Code Review

Development Guidelines

1. Code Style

2. Testing

3. Documentation

4. Commit Messages

Getting Help

• Join our Discord community
• Check the documentation
• Ask questions in GitHub discussions
• Attend our monthly contributor calls

Security

• The server validates all inputs before processing
• API keys are never logged or exposed in error messages
• The stdio transport provides process isolation
• All external API calls use HTTPS
• Input validation prevents injection attacks

License

MIT