mcp-server/
├── src/
│   ├── mcp-server/
│   │   └── index.ts          # MCP server with 7 tools
│   ├── providers/
│   │   ├── index.ts          # Provider registry
│   │   ├── claude.ts         # Anthropic Claude
│   │   ├── groq.ts           # Groq (Llama)
│   │   ├── openai.ts         # OpenAI (GPT)
│   │   ├── openrouter.ts     # OpenRouter
│   │   ├── ollama.ts         # Ollama (local)
│   │   └── gemini.ts         # Google Gemini
│   ├── services/
│   │   ├── claude.service.ts
│   │   ├── groq.service.ts
│   │   ├── openai.service.ts
│   │   ├── openrouter.service.ts
│   │   ├── ollama.service.ts
│   │   └── gemini.service.ts
│   ├── config/
│   │   └── envs.ts           # Environment config
│   ├── types/
│   │   └── common.ts         # Shared types
│   └── agent.ts              # Standalone terminal agent
├── .env                      # API keys (never commit)
├── package.json
└── tsconfig.json

git clone https://github.com/naushadraien/mcp-server.git
cd mcp-server
bun install

# Choose your provider
PROVIDER=groq   # groq | claude | openai | openrouter | ollama | gemini

# Add the API key for your chosen provider
GROQ_API_KEY=your_groq_key_here
ANTHROPIC_API_KEY=your_anthropic_key_here
OPENAI_API_KEY=your_openai_key_here
OPENROUTER_API_KEY=your_openrouter_key_here
GEMINI_API_KEY=your_gemini_key_here
# Ollama needs no API key — runs locally

bun dev

🚀 Starting MCP dev-tools agent...
✅ MCP server connected. Tools available:
   • read_file
   • write_file
   • list_directory
   • run_command
   • search_in_files
   • create_directory
   • delete_file

You: read C:/Projects/myapp/package.json and tell me the dependencies
🔧 [1/5] Calling: read_file
...

PROVIDER=groq        # Groq Llama 3.3 — free 100k tokens/day
PROVIDER=claude      # Anthropic Claude — best quality
PROVIDER=openai      # OpenAI GPT-4o
PROVIDER=openrouter  # OpenRouter — access to many models
PROVIDER=gemini      # Google Gemini — free 1500 req/day
PROVIDER=ollama      # Local Ollama — free, no limits

# Read a file
read C:/Projects/myapp/package.json and show me all dependencies

# List project structure
list all files in C:/Projects/myapp/src recursively

# Search codebase
search for "TODO" in C:/Projects/myapp/src with extension .ts

# Run a command
run "npm run build" in C:/Projects/myapp

# Chain multiple tools
list all files in src, read index.ts and write a summary to SUMMARY.md

# Generate documentation
read all files in src and write a complete README.md

mcpServers:
  - name: dev-tools
    command: bun
    args:
      - run
      - C:/<your-path>/mcp-server/src/mcp-server/index.ts

server.registerTool(
  "my_tool",                          // tool name
  {
    title: "My Tool",                 // human-readable title
    description: "What this tool does", // what the AI sees
    inputSchema: {
      param1: z.string().describe("Description of param1"),
      param2: z.number().optional().describe("Optional param"),
    },
  },
  async ({ param1, param2 }) => {
    // your code here — call APIs, query DB, anything
    const result = await doSomething(param1);
    return {
      content: [{ type: "text", text: result }],
    };
  }
);