# 🚀 MeshSeeks - Quick Start Guide
Get up and running with MeshSeeks in under 5 minutes!
## Prerequisites
1. Node.js v20+ installed
2. Claude CLI installed and configured ([install guide](https://claude.ai/cli))
3. Claude Desktop or another MCP-compatible client
## 🎯 Fastest Setup
1. **Clone and build:**
```bash
git clone https://github.com/twalichiewicz/meshseeks.git
cd meshseeks
npm install && npm run build
```
2. **Add to your MCP configuration file:**
```json
{
"mcpServers": {
"meshseeks": {
"command": "node",
"args": ["/path/to/meshseeks/dist/mesh-server.js"],
"env": {
"MCP_CLAUDE_DEBUG": "false"
}
}
}
}
```
> Replace `/path/to/meshseeks` with the actual path where you cloned the repo
2. **Save the file to the correct location:**
- Claude Desktop: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
- Cursor: `~/.cursor/mcp.json`
- Windsurf: `~/.codeium/windsurf/mcp_config.json`
3. **Restart your MCP client** (Claude Desktop, Cursor, etc.)
4. **Test it's working:**
```
Use the claude_code tool to create a file test.txt with content "Hello MCP!"
```
## 🛠️ Available Tools
### 1. claude_code
Execute Claude Code commands with full system access:
```json
{
"prompt": "Create a new Python file hello.py that prints 'Hello World'",
"workFolder": "/path/to/project"
}
```
### 2. health
Check server status:
```json
{
"toolName": "claude_code:health"
}
```
### 3. convert_task_markdown
**Automatically converts human-readable markdown task lists into MCP-compliant JSON commands that Claude Code executes sequentially!**
```mermaid
graph TD
A[📝 Multi-Task Markdown] -->|🔄 convert_task_markdown| B{✓ Valid Format?}
B -->|❌ Error| C[📑 Fix Instructions]
C -->|Return to| A
B -->|✅ Success| D[📋 MCP Task List]
D -->|Execute| E[⚡ Claude Task #1]
E -->|Complete| F[⚡ Claude Task #2]
F -->|Complete| G[⚡ Claude Task #3]
G -->|Complete| H[... More Tasks ...]
H -->|Execute| I[⚡ Claude Task #N]
I -->|Complete| J[✅ All Tasks Done]
style A fill:#FF9800,stroke:#fff,stroke-width:2px,color:#fff
style B fill:#9C27B0,stroke:#fff,stroke-width:2px,color:#fff
style C fill:#F44336,stroke:#fff,stroke-width:2px,color:#fff
style D fill:#2196F3,stroke:#fff,stroke-width:2px,color:#fff
style E fill:#FFC107,stroke:#fff,stroke-width:2px,color:#fff
style F fill:#FFC107,stroke:#fff,stroke-width:2px,color:#fff
style G fill:#FFC107,stroke:#fff,stroke-width:2px,color:#fff
style H fill:#9E9E9E,stroke:#fff,stroke-width:2px,color:#fff
style I fill:#FFC107,stroke:#fff,stroke-width:2px,color:#fff
style J fill:#4CAF50,stroke:#fff,stroke-width:2px,color:#fff
```
This powerful tool transforms your TODO lists into executable code operations:
```json
{
"markdownPath": "/path/to/tasks.md"
}
```
**What it does:**
- Takes a markdown file with human-readable tasks (like "Create user authentication module")
- Converts them to exact, executable commands (like `cd /project && python create_auth.py`)
- Outputs MCP-compliant JSON that Claude Code can run step-by-step
- No more manual command translation - just write what you want done!
## 📝 Basic Examples
### Create a file
```
Use claude_code to create index.html with a basic HTML5 template
```
### Run a git operation
```
Use claude_code to commit all changes with message "Initial commit"
```
### Convert a task list to executable commands
```
Use convert_task_markdown to convert my tasks.md file to MCP commands
```
**Example: Your markdown file says:**
```markdown
- [ ] Create user authentication module
- [ ] Add login endpoint
- [ ] Write unit tests
```
**The tool automatically converts to:**
```json
[
{
"tool": "claude_code",
"arguments": {
"prompt": "cd /project && create auth_module.py...",
"workFolder": "/project"
}
},
{
"tool": "claude_code",
"arguments": {
"prompt": "cd /project && add login endpoint to api/routes.py...",
"workFolder": "/project"
}
},
// ... more tasks
]
```
**Claude Code then executes each task sequentially!** 🚀
## 🔧 Common Issues
1. **"Command not found"**: Make sure Node.js v20+ is installed
2. **Permission errors**: Run `claude --dangerously-skip-permissions` once first
3. **Tool not showing**: Restart your MCP client after configuration
## 📚 Next Steps
- Read the [full documentation](README.md) for advanced features
- Explore [task orchestration patterns](README.md#-task-orchestration-patterns)
- Learn about [Roo modes](README.md#-roo-modes-integration)
- Check out [example use cases](README.md#-key-use-cases)
## 🆘 Need Help?
- [GitHub Issues](https://github.com/twalichiewicz/meshseeks/issues)
- [Full Documentation](README.md)
- [Troubleshooting Guide](README.md#-troubleshooting)
---
*Ready in 5 minutes, powerful for a lifetime! 🚀*
