|
| 1 | +# ToolPipe MCP Server Extension |
| 2 | + |
| 3 | +This VS Code extension provides seamless integration with **ToolPipe MCP Server**, giving you access to 120+ developer utilities through the Model Context Protocol (MCP). |
| 4 | + |
| 5 | +## Features |
| 6 | + |
| 7 | +### ✨ 120+ Developer Utilities |
| 8 | + |
| 9 | +ToolPipe MCP Server provides comprehensive developer tools organized into five categories: |
| 10 | + |
| 11 | +#### 🔧 Code Tools |
| 12 | +- JavaScript/TypeScript: Formatting, minification, code review, AST analysis |
| 13 | +- Python: Code formatting, linting, syntax checking |
| 14 | +- SQL: Query formatting, optimization, validation |
| 15 | +- CSS/SCSS/LESS: Formatting, minification, validation |
| 16 | +- HTML: Formatting, validation, optimization |
| 17 | + |
| 18 | +#### 📊 Data Tools |
| 19 | +- JSON: Formatting, validation, transformation, schema analysis |
| 20 | +- CSV: Parsing, formatting, conversion to JSON/XML |
| 21 | +- XML: Formatting, validation, transformation |
| 22 | +- YAML: Formatting, validation, conversion |
| 23 | +- Encoding: Base64 encode/decode, hex conversion, URL encoding |
| 24 | +- Generators: UUID generation, random data generation |
| 25 | + |
| 26 | +#### 🔒 Security Tools |
| 27 | +- Hash Generation: MD5, SHA-1, SHA-256, SHA-512, HMAC |
| 28 | +- JWT: Decode and validate JWT tokens |
| 29 | +- SSL/TLS: Certificate validation and analysis |
| 30 | +- Security Headers: Analysis and validation |
| 31 | +- Password Generation: Secure password creation |
| 32 | + |
| 33 | +#### 🌐 API Tools |
| 34 | +- HTTP Client: Make HTTP requests with custom headers |
| 35 | +- OpenAPI: Spec generation and documentation |
| 36 | +- Webhook Testing: Webhook URL generation and testing |
| 37 | +- API Documentation: Auto-generate from code comments |
| 38 | +- REST Builder: Interactive REST API builder |
| 39 | + |
| 40 | +#### 🚀 DevOps Tools |
| 41 | +- Docker: Docker Compose generation, container commands |
| 42 | +- GitHub Actions: Workflow generation and validation |
| 43 | +- Nginx: Configuration generation and validation |
| 44 | +- Kubernetes: YAML generation and validation |
| 45 | +- Environment: System information and diagnostics |
| 46 | + |
| 47 | +## Installation |
| 48 | + |
| 49 | +1. Install this extension from the VS Code Marketplace |
| 50 | +2. Reload VS Code |
| 51 | +3. The extension will be automatically activated |
| 52 | + |
| 53 | +## Configuration |
| 54 | + |
| 55 | +### Quick Start (Remote Mode - Recommended) |
| 56 | + |
| 57 | +By default, ToolPipe uses the **remote cloud-hosted server** which requires no additional setup: |
| 58 | + |
| 59 | +```json |
| 60 | +{ |
| 61 | + "toolpipeMcpServer.enabled": true, |
| 62 | + "toolpipeMcpServer.mode": "remote", |
| 63 | + "toolpipeMcpServer.remoteUrl": "https://troops-submission-what-stays.trycloudflare.com/mcp" |
| 64 | +} |
| 65 | +``` |
| 66 | + |
| 67 | +### Advanced Configuration |
| 68 | + |
| 69 | +#### Using Local Server |
| 70 | + |
| 71 | +To run ToolPipe locally (requires Node.js and npm): |
| 72 | + |
| 73 | +```bash |
| 74 | +npm install -g @cosai-labs/toolpipe-mcp-server |
| 75 | +``` |
| 76 | + |
| 77 | +Then configure VS Code: |
| 78 | + |
| 79 | +```json |
| 80 | +{ |
| 81 | + "toolpipeMcpServer.enabled": true, |
| 82 | + "toolpipeMcpServer.mode": "local", |
| 83 | + "toolpipeMcpServer.localCommand": "npx", |
| 84 | + "toolpipeMcpServer.localArgs": ["@cosai-labs/toolpipe-mcp-server"] |
| 85 | +} |
| 86 | +``` |
| 87 | + |
| 88 | +#### Disabling the Extension |
| 89 | + |
| 90 | +To disable ToolPipe integration: |
| 91 | + |
| 92 | +```json |
| 93 | +{ |
| 94 | + "toolpipeMcpServer.enabled": false |
| 95 | +} |
| 96 | +``` |
| 97 | + |
| 98 | +## Usage with AI Assistants |
| 99 | + |
| 100 | +Once configured, ToolPipe tools are automatically available to: |
| 101 | +- **Copilot Chat**: Use `/explain` or chat tools to access utilities |
| 102 | +- **Claude Desktop**: Via MCP server connection |
| 103 | +- **Cursor/Windsurf**: Integrated through MCP protocol |
| 104 | +- **Cline**: Via MCP server endpoints |
| 105 | + |
| 106 | +## Configuration Reference |
| 107 | + |
| 108 | +### Settings |
| 109 | + |
| 110 | +| Setting | Type | Default | Description | |
| 111 | +|---------|------|---------|-------------| |
| 112 | +| `toolpipeMcpServer.enabled` | boolean | `true` | Enable/disable the extension | |
| 113 | +| `toolpipeMcpServer.mode` | string | `remote` | Connection mode: `remote` or `local` | |
| 114 | +| `toolpipeMcpServer.remoteUrl` | string | `https://troops-submission-what-stays.trycloudflare.com/mcp` | Remote server URL | |
| 115 | +| `toolpipeMcpServer.localCommand` | string | `npx` | Command for local server | |
| 116 | +| `toolpipeMcpServer.localArgs` | array | `["@cosai-labs/toolpipe-mcp-server"]` | Arguments for local server | |
| 117 | + |
| 118 | +## Direct MCP Configuration |
| 119 | + |
| 120 | +You can also configure ToolPipe directly in your `.vscode/mcp.json`: |
| 121 | + |
| 122 | +### Remote Server (HTTP) |
| 123 | +```json |
| 124 | +{ |
| 125 | + "mcp": { |
| 126 | + "servers": { |
| 127 | + "toolpipe": { |
| 128 | + "type": "http", |
| 129 | + "url": "https://troops-submission-what-stays.trycloudflare.com/mcp" |
| 130 | + } |
| 131 | + } |
| 132 | + } |
| 133 | +} |
| 134 | +``` |
| 135 | + |
| 136 | +### Local Server (Stdio) |
| 137 | +```json |
| 138 | +{ |
| 139 | + "mcp": { |
| 140 | + "servers": { |
| 141 | + "toolpipe": { |
| 142 | + "type": "stdio", |
| 143 | + "command": "npx", |
| 144 | + "args": ["@cosai-labs/toolpipe-mcp-server"] |
| 145 | + } |
| 146 | + } |
| 147 | + } |
| 148 | +} |
| 149 | +``` |
| 150 | + |
| 151 | +## Examples |
| 152 | + |
| 153 | +### JSON Formatting with Copilot Chat |
| 154 | +``` |
| 155 | +@copilot Format this JSON: |
| 156 | +{ |
| 157 | + "name":"John", |
| 158 | + "age":30 |
| 159 | +} |
| 160 | +``` |
| 161 | +Copilot will use ToolPipe's JSON formatting tool automatically. |
| 162 | + |
| 163 | +### Code Review |
| 164 | +``` |
| 165 | +@copilot Can you review this TypeScript code? |
| 166 | +[paste code] |
| 167 | +``` |
| 168 | +ToolPipe's code review tools will be available in the context. |
| 169 | + |
| 170 | +### Hash Generation |
| 171 | +``` |
| 172 | +@copilot Generate SHA-256 hash of "my-password" |
| 173 | +``` |
| 174 | +ToolPipe provides instant hash generation. |
| 175 | + |
| 176 | +## Troubleshooting |
| 177 | + |
| 178 | +### Server not connecting |
| 179 | +1. Check if the extension is enabled in settings |
| 180 | +2. For remote mode: verify internet connection |
| 181 | +3. For local mode: ensure Node.js and npm are installed |
| 182 | +4. Check VS Code's output panel for error messages |
| 183 | + |
| 184 | +### Tools not appearing in chat |
| 185 | +1. Reload VS Code window (Cmd+Shift+P → "Developer: Reload Window") |
| 186 | +2. Verify the MCP server started successfully (check Output → "ToolPipe MCP Server") |
| 187 | +3. Restart Copilot Chat |
| 188 | + |
| 189 | +### Local server not starting |
| 190 | +```bash |
| 191 | +# Test if the package is installed |
| 192 | +npx @cosai-labs/toolpipe-mcp-server --help |
| 193 | + |
| 194 | +# Install globally if needed |
| 195 | +npm install -g @cosai-labs/toolpipe-mcp-server |
| 196 | +``` |
| 197 | + |
| 198 | +## Links |
| 199 | + |
| 200 | +- **npm**: https://www.npmjs.com/package/@cosai-labs/toolpipe-mcp-server |
| 201 | +- **GitHub**: https://github.com/COSAI-Labs/make-money-30day-challenge/tree/master/products/mcp-server |
| 202 | +- **MCP Protocol**: https://modelcontextprotocol.io/ |
| 203 | +- **VS Code Docs**: https://code.visualstudio.com/docs |
| 204 | + |
| 205 | +## License |
| 206 | + |
| 207 | +MIT - See LICENSE file for details |
| 208 | + |
| 209 | +## Contributing |
| 210 | + |
| 211 | +Contributions are welcome! Please submit issues and pull requests to the VS Code repository. |
| 212 | + |
| 213 | +## Support |
| 214 | + |
| 215 | +For issues with: |
| 216 | +- **ToolPipe Server**: https://github.com/COSAI-Labs/make-money-30day-challenge/issues |
| 217 | +- **VS Code Integration**: https://github.com/microsoft/vscode/issues |
| 218 | +- **MCP Protocol**: https://github.com/modelcontextprotocol/specification/issues |
0 commit comments