Initial commit

This commit is contained in:
Zhongwei Li
2025-11-29 18:13:08 +08:00
commit 3846512f75
4 changed files with 226 additions and 0 deletions

View File

@@ -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"
]
}

3
README.md Normal file
View File

@@ -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.

View File

@@ -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

45
plugin.lock.json Normal file
View File

@@ -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": []
}
}