From 3846512f757c52b997488677d6458382a278c5a9 Mon Sep 17 00:00:00 2001
From: Zhongwei Li <lizhongwei.nkcs@gmail.com>
Date: Sat, 29 Nov 2025 18:13:08 +0800
Subject: [PATCH] Initial commit

---
 .claude-plugin/plugin.json           |  12 ++
 README.md                            |   3 +
 commands/claude-desktop-extension.md | 166 +++++++++++++++++++++++++++
 plugin.lock.json                     |  45 ++++++++
 4 files changed, 226 insertions(+)
 create mode 100644 .claude-plugin/plugin.json
 create mode 100644 README.md
 create mode 100644 commands/claude-desktop-extension.md
 create mode 100644 plugin.lock.json

diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
new file mode 100644
index 0000000..4968939
--- /dev/null
+++ b/.claude-plugin/plugin.json
@@ -0,0 +1,12 @@
+{
+  "name": "desktop-integrator",
+  "description": "This command provides the context necessary for Claude Code to create the Desktop Extension or .dxt file of an MCP.",
+  "version": "1.0.0",
+  "author": {
+    "name": "ClaudeForge Community",
+    "url": "https://github.com/claudeforge/marketplace"
+  },
+  "commands": [
+    "./commands"
+  ]
+}
\ No newline at end of file
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..93f7456
--- /dev/null
+++ b/README.md
@@ -0,0 +1,3 @@
+# desktop-integrator
+
+This command provides the context necessary for Claude Code to create the Desktop Extension or .dxt file of an MCP.
diff --git a/commands/claude-desktop-extension.md b/commands/claude-desktop-extension.md
new file mode 100644
index 0000000..cc666d3
--- /dev/null
+++ b/commands/claude-desktop-extension.md
@@ -0,0 +1,166 @@
+---
+description: Build Claude Desktop Extensions (DXT) with proper MCP server setup and manifest configuration
+version: 1.0.0
+---
+
+# Claude Desktop Extension Builder
+
+Build Claude Desktop Extensions using the Model Context Protocol to extend Claude Desktop with custom tools and capabilities.
+
+## What It Does
+
+- Creates MCP-compatible server implementations
+- Generates valid extension manifest files
+- Sets up proper tool definitions and schemas
+- Configures stdio transport for local execution
+- Enables custom functionality in Claude Desktop
+
+## How to Use
+
+Run this command when you want to create a new Desktop Extension:
+
+```bash
+/claude-desktop-extension
+```
+
+The command will guide you through creating a complete extension with server code and manifest.
+
+## Example Structure
+
+A basic DXT includes two main files:
+
+**manifest.json**
+```json
+{
+  "name": "my-extension",
+  "version": "1.0.0",
+  "description": "Custom tools for Claude",
+  "main": "server.js",
+  "mcp": {
+    "transport": "stdio"
+  }
+}
+```
+
+**server.js**
+```javascript
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+
+const server = new Server({
+  name: 'my-extension',
+  version: '1.0.0'
+}, {
+  capabilities: {
+    tools: {}
+  }
+});
+
+server.setRequestHandler('tools/list', async () => ({
+  tools: [{
+    name: 'my_tool',
+    description: 'Does something useful',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        input: { type: 'string' }
+      }
+    }
+  }]
+}));
+
+server.setRequestHandler('tools/call', async (request) => {
+  const { name, arguments: args } = request.params;
+
+  if (name === 'my_tool') {
+    return {
+      content: [{ type: 'text', text: `Processed: ${args.input}` }]
+    };
+  }
+
+  throw new Error(`Unknown tool: ${name}`);
+});
+
+const transport = new StdioServerTransport();
+await server.connect(transport);
+```
+
+## Use Cases
+
+- **File System Tools**: Add custom file operations beyond built-in capabilities
+- **API Integrations**: Connect Claude to external services and APIs
+- **Data Processing**: Create specialized data transformation tools
+- **System Utilities**: Access system information or execute commands
+- **Database Access**: Query and modify database contents
+
+## Best Practices
+
+- **Error Handling**: Wrap tool logic in try-catch blocks and return meaningful error messages
+- **Input Validation**: Use JSON Schema to validate tool inputs before processing
+- **Async Operations**: Use async/await for I/O operations and external API calls
+- **Logging**: Add console.error() for debugging (output goes to Claude Desktop logs)
+- **Tool Naming**: Use snake_case for tool names and be descriptive
+- **Schema Design**: Define clear input schemas with required fields and types
+- **Response Format**: Always return structured content arrays
+- **Testing**: Test with sample inputs before deploying to Claude Desktop
+
+## Installation
+
+After building your extension:
+
+1. Save files in a dedicated directory
+2. Run `npm install @modelcontextprotocol/sdk`
+3. Add to Claude Desktop config:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "my-extension": {
+      "command": "node",
+      "args": ["/path/to/your/server.js"]
+    }
+  }
+}
+```
+
+4. Restart Claude Desktop
+
+## Common Patterns
+
+**Reading environment variables:**
+```javascript
+const apiKey = process.env.API_KEY;
+if (!apiKey) {
+  throw new Error('API_KEY not configured');
+}
+```
+
+**Making HTTP requests:**
+```javascript
+const response = await fetch('https://api.example.com/data');
+const data = await response.json();
+return { content: [{ type: 'text', text: JSON.stringify(data) }] };
+```
+
+**File operations:**
+```javascript
+import fs from 'fs/promises';
+const content = await fs.readFile(args.path, 'utf-8');
+return { content: [{ type: 'text', text: content }] };
+```
+
+## Troubleshooting
+
+- **Extension not appearing**: Check Claude Desktop logs for connection errors
+- **Tool failures**: Ensure proper error handling and valid return formats
+- **Transport issues**: Verify stdio transport is configured correctly
+- **Schema validation**: Test input schemas match your tool expectations
+
+## Resources
+
+- DXT Documentation: https://github.com/anthropics/dxt
+- MCP SDK: https://github.com/modelcontextprotocol
+- Examples: https://github.com/anthropics/dxt/tree/main/examples
diff --git a/plugin.lock.json b/plugin.lock.json
new file mode 100644
index 0000000..ef8dbcc
--- /dev/null
+++ b/plugin.lock.json
@@ -0,0 +1,45 @@
+{
+  "$schema": "internal://schemas/plugin.lock.v1.json",
+  "pluginId": "gh:claudeforge/marketplace:plugins/commands/desktop-integrator",
+  "normalized": {
+    "repo": null,
+    "ref": "refs/tags/v20251128.0",
+    "commit": "2383c52297c5f33da851cdaa5e73d3339f6ba1b5",
+    "treeHash": "246f7c4a61654ab988724532698c254e57aabbbf99cef2a6772c9d0c3009af0b",
+    "generatedAt": "2025-11-28T10:15:28.885659Z",
+    "toolVersion": "publish_plugins.py@0.2.0"
+  },
+  "origin": {
+    "remote": "git@github.com:zhongweili/42plugin-data.git",
+    "branch": "master",
+    "commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390",
+    "repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data"
+  },
+  "manifest": {
+    "name": "desktop-integrator",
+    "description": "This command provides the context necessary for Claude Code to create the Desktop Extension or .dxt file of an MCP.",
+    "version": "1.0.0"
+  },
+  "content": {
+    "files": [
+      {
+        "path": "README.md",
+        "sha256": "15cbdbe9215ff4077f6d1b03a7ed237f2c78ab72cd5cdeda2d5bf016ecfff338"
+      },
+      {
+        "path": ".claude-plugin/plugin.json",
+        "sha256": "04264fb9c492108914e84e420e03438db371b6c26a81e94cab34f053511d34d6"
+      },
+      {
+        "path": "commands/claude-desktop-extension.md",
+        "sha256": "e98dc77f9adf2e57bda1d3a4765212020dfb15351d439acb9b6c0537615425be"
+      }
+    ],
+    "dirSha256": "246f7c4a61654ab988724532698c254e57aabbbf99cef2a6772c9d0c3009af0b"
+  },
+  "security": {
+    "scannedAt": null,
+    "scannerVersion": null,
+    "flags": []
+  }
+}
\ No newline at end of file