Dock ASO MCP Server

MCP (Model Context Protocol) server that enables Claude Desktop to interact with the Dock ASO Tracker app for keyword analysis and ASO content management.

Features

This MCP server provides the following tools to Claude:

1. get_apps_and_languages

Get the list of all apps configured in Dock with their available languages and platforms.

2. get_app_keywords_analysis

Get detailed keyword analysis including:

• App metadata (name, title, subtitle, keywords field, description)
• Main keyword with ranking and opportunity index
• Monitored keywords with ranking and opportunity index
• For each keyword: popularity, difficulty, ranking position, opportunity index
• Difficulty breakdown: maturity, strength, competitors, concentration

3. get_app_aso_content

Get current ASO content:

• Title (max 30 characters)
• Subtitle (max 30 characters)
• Keywords field (max 100 characters)
• Description (max 4000 characters)
• Analysis of which keywords are used in each field

4. update_app_aso_content

Update ASO content in Dock. Changes are saved locally and can be synced to App Store Connect from the app.

Installation

Prerequisites

1. Dock app must be installed and running with MCP server enabled
2. Node.js 18 or later
3. Claude Desktop app

Setup

1. Open Dock app
2. Go to Settings → Claude Integration
3. Enable "MCP Server"
4. Note the port (default: 8765)

Configure Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "dock": {
      "command": "npx",
      "args": ["-y", "dock-aso-mcp-server"],
      "env": {
        "DOCK_PORT": "8765"
      }
    }
  }
}

Or if you have cloned this repository locally:

{
  "mcpServers": {
    "dock": {
      "command": "node",
      "args": ["/path/to/dock-aso-mcp-server/dist/index.js"],
      "env": {
        "DOCK_PORT": "8765"
      }
    }
  }
}

3. Restart Claude Desktop

Usage Examples

Analyzing Keywords

User: Analyze the keywords for my app

Claude: I'll first get the list of apps available in Dock.
[Uses get_apps_and_languages tool]

Here are your apps:
1. My App (com.example.myapp)
   - Languages: 🇺🇸 English (US), 🇮🇹 Italian
   - Platforms: IOS, MAC_OS

Which app and language would you like me to analyze?

User: Analyze My App in English

Claude: [Uses get_app_keywords_analysis tool]

Here's the keyword analysis for My App (English):

**Main Keyword:** "productivity app"
- Popularity: 65%
- Difficulty: 45%
- Ranking: #12
- Opportunity Index: 72%

**Monitored Keywords:**
| Keyword | Popularity | Difficulty | Ranking | Opportunity |
|---------|------------|------------|---------|-------------|
| task manager | 78% | 52% | #8 | 68% |
| todo list | 82% | 61% | #15 | 58% |
| ...

Recommendations:
- "task manager" has the best ranking (#8) and good opportunity (68%)
- Consider targeting "productivity app" in your title as it has high opportunity

Proposing New ASO Content

User: Propose new ASO content for my app

Claude: [Uses get_app_aso_content tool]

Current ASO content:
- Title: "My App" (6/30 chars)
- Subtitle: "Simple task management" (22/30 chars)
- Keywords: "task,todo,productivity" (22/100 chars)

Based on the keyword analysis, here are my recommendations:

**New Title:** "My App - Task Manager" (21/30 chars)
- Includes "task manager" (ranked #8)

**New Subtitle:** "Productivity & Todo Lists" (25/30 chars)
- Includes "productivity" and "todo"

**New Keywords:** "task manager,todo list,productivity app,organize,schedule,planner,reminders" (77/100 chars)

Would you like me to apply these changes?

User: Yes, apply title and subtitle

Claude: [Uses update_app_aso_content tool]

Done! I've updated:
- Title: "My App - Task Manager"
- Subtitle: "Productivity & Todo Lists"

Open Dock and sync with App Store Connect to apply the changes.

Development

Building

cd dock-aso-mcp-server
npm install
npm run build

Testing locally

# Start the server in development mode
npm run dev

# Or run the built version
npm start

Troubleshooting

"Failed to connect to Dock"

• Make sure Dock app is running
• Check that MCP server is enabled in Settings → Claude Integration
• Verify the port matches your configuration

Claude doesn't see the tools

• Restart Claude Desktop after configuration changes
• Check the configuration file path is correct
• Verify JSON syntax in the configuration

License

MIT