Changerawr/mcp-server

Changerawr MCP Server

A Model Context Protocol (MCP) server for Changerawr, enabling AI assistants like Claude to manage changelogs, projects, and content through natural language.

Features

🚀 Project Management

• List, create, update, and delete projects
• Configure project settings (public visibility, auto-publish, approval requirements)

📝 Changelog Management

• Create, update, publish, and unpublish changelog entries
• Support for versioning and tagging
• Markdown content with rich formatting

🏷️ Tag Organization

• Create and manage tags for organizing entries
• Project-specific tag management

📊 Analytics & Insights

• Get dashboard statistics and analytics
• Track project information

🔧 Project Settings

• Update project configuration
• Manage default tags and publishing settings

Installation & Setup

Prerequisites

• Node.js 18+ installed
• Access to a Changerawr instance
• An admin API key from Changerawr

1. Clone the Repository

git clone <repository-url>
cd changerawr-mcp-server

2. Install Dependencies

npm install

3. Get Your Changerawr API Key

1. Log in to your Changerawr admin panel
2. Navigate to Settings → API Keys
3. Create a new API key with admin permissions
4. Copy the key (format: chr_...)

4. Configure Claude Desktop

Add this configuration to your Claude Desktop config.json:

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

{
  "mcpServers": {
    "changerawr": {
      "command": "npx",
      "args": ["tsx", "C:\\Users\\username\\WebstormProjects\\changerawr-mcp-server\\src\\index.ts"],
      "env": {
        "CHANGERAWR_API_KEY": "chr_your_api_key_here",
        "CHANGERAWR_BASE_URL": "https://your-changerawr-domain.com",
        "NODE_ENV": "development"
      }
    }
  }
}

Important: Replace the path with your actual project location and update the environment variables:

• CHANGERAWR_API_KEY: Your actual API key from Changerawr
• CHANGERAWR_BASE_URL: Your Changerawr instance URL

5. Restart Claude Desktop

Close Claude Desktop completely and restart it for the configuration to take effect.

Usage Examples

Project Management

Create a new project:

"Create a new project called 'Mobile App' with auto-publish enabled and make it public"

List all projects:

"Show me all my projects in Changerawr"

Update project settings:

"Make the Mobile App project private and require approval for all changes"

Changelog Management

Create a draft changelog entry:

"Create a changelog entry for version 2.1.0 titled 'Enhanced Search Features' with details about the new search functionality"

Create and publish immediately:

"Create and immediately publish a changelog entry for version 2.1.1 about bug fixes"

Publish a draft:

"Show me unpublished changelog entries and publish the one about enhanced security"

Update an existing entry:

"Update the changelog entry with ID xyz to include information about performance improvements"

Tag Management

List tags for a project:

"Show me all tags available for the Mobile App project"

Create a new tag:

"Create a new tag called 'Security Update' for the Mobile App project"

Analytics

Get dashboard statistics:

"Show me the dashboard statistics and recent activity"

Available Tools

The MCP server provides 22 tools for comprehensive Changerawr management:

Project Tools (5)

• list_projects - List all projects
• get_project - Get project details
• create_project - Create new project
• update_project - Update project settings
• delete_project - Delete project (admin)

Changelog Tools (8)

• list_changelog_entries - List changelog entries with filtering
• get_changelog_entry - Get specific entry details
• create_changelog_entry - Create new draft entry
• update_changelog_entry - Update existing entry
• publish_changelog_entry - Publish entry to make it public
• unpublish_changelog_entry - Hide entry from public
• delete_changelog_entry - Delete entry permanently (admin)
• create_and_publish_changelog_entry - Create and publish in one step

Tag Tools (3)

• list_tags - List tags for a project
• create_tag - Create new project tag
• delete_tag - Delete tag (limited API support)

Settings Tools (2)

• get_project_settings - Get project configuration
• update_project_settings - Update project settings

Analytics Tools (1)

• get_dashboard_stats - Get dashboard statistics

Resources (3)

• changerawr://projects - List of all projects
• changerawr://projects/{projectId}/changelog - Project changelog entries
• changerawr://tags - Available tags

Workflows

Draft → Review → Publish (Recommended)

1. Create Draft: create_changelog_entry - Creates unpublished entry
2. Review Content: Edit and review the content
3. Publish: publish_changelog_entry - Makes it visible to users

Immediate Publishing

1. Create & Publish: create_and_publish_changelog_entry - One-step process

Admin Permissions

All API keys have admin access, enabling:

• ✅ Instant project creation/deletion
• ✅ Immediate publish/unpublish
• ✅ Direct entry deletion
• ✅ Full project settings control
• ✅ Tag management

Troubleshooting

Connection Issues

1. Verify API key: Ensure it starts with chr_ and has admin permissions
2. Check URL: Verify your Changerawr instance URL is correct
3. Test connection: Try accessing your Changerawr instance in a browser

Claude Desktop Issues

1. Check logs: Windows: %APPDATA%\Claude\logs\
2. Restart completely: Close Claude Desktop from system tray
3. Verify config path: Ensure the file path in config.json is correct

Tool Failures

1. Check stderr output: The MCP server logs detailed error information
2. Verify project IDs: Ensure you're using correct project/entry IDs
3. API permissions: Confirm your API key has admin access

Development

Run in Development Mode

cd changerawr-mcp-server
npx tsx src/index.ts

Testing Tools

Use the MCP Inspector for testing:

npx @modelcontextprotocol/inspector npx tsx src/index.ts

Environment Variables

Architecture

src/
├── index.ts              # Main MCP server entry point
├── client/
│   └── changerawr-client.ts  # API client with Zod validation
├── tools/                # MCP tools for AI interactions
│   ├── index.ts          # Tool registry
│   ├── project-tools.ts  # Project management (5 tools)
│   ├── changelog-tools.ts # Changelog operations (8 tools)
│   ├── tag-tools.ts      # Tag management (3 tools)
│   ├── settings-tools.ts # Project settings (2 tools)
│   └── analytics-tools.ts # Dashboard analytics (1 tool)
├── resources/            # MCP resources for data access
│   ├── index.ts          # Resource registry
│   ├── project-resources.ts
│   └── changelog-resources.ts
└── utils/
    └── validation.ts     # Input validation utilities

Security

• Uses Changerawr's existing API key authentication
• Respects admin permissions and role-based access
• All operations logged via Changerawr's audit system
• Input validation and error handling for safe operations

License

MIT License - see LICENSE file for details

Support

For issues and questions:

• Check the troubleshooting section above
• Review Claude Desktop logs for detailed error information
• Ensure your Changerawr instance is accessible and API key is valid