MCP Toolkit Server

Übersicht

Der MCP Toolkit Server ist ein produktionsreifer Model Context Protocol (MCP)-Server, der Claude, ChatGPT und andere LLM-Agenten mit einer umfangreichen Sammlung von Tools für die Interaktion mit Datenbanken, externen APIs, dem Dateisystem und mehr ausstattet – direkt relevant für die Agentic AI-Welle.

Dieser Server wurde mit TypeScript und dem offiziellen @modelcontextprotocol/sdk entwickelt, läuft als lokaler stdio-Prozess und lässt sich nahtlos in Claude Desktop, den MCP Inspector oder jeden anderen MCP-kompatiblen Client integrieren.

Related MCP server: MCP Toolkit

Funktionen & Tools

Schnellstart

Voraussetzungen

• Node.js >= 18.0.0

• npm >= 9.0.0

Installation

# Clone the repository
git clone https://github.com/vyshnavi-nandyala/mcp-toolkit-server.git
cd mcp-toolkit-server

# Install dependencies
npm install

# Build the TypeScript project
npm run build

Claude Desktop konfigurieren

Fügen Sie den Server zu Ihrer Claude Desktop-Konfigurationsdatei hinzu:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "toolkit": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-toolkit-server/dist/index.js"]
    }
  }
}

Ersetzen Sie /absolute/path/to/mcp-toolkit-server durch den tatsächlichen Pfad auf Ihrem Computer.

Starten Sie Claude Desktop neu, und Sie werden ein 🔨-Symbol im Eingabebereich sehen – Ihre Tools sind bereit!

Verwendung mit MCP Inspector (Debugging)

npx @modelcontextprotocol/inspector node dist/index.js

Dies öffnet eine Web-Benutzeroberfläche, in der Sie jedes Tool manuell testen, Anfrage-/Antwort-Payloads untersuchen und Probleme debuggen können.

Anwendungsbeispiele

Datenbankabfrage — Die Demo-Datenbank erkunden

Fragen Sie Claude:

"Zeige mir die 5 besten Produkte nach Preis aus der Demo-Datenbank."

Claude wird das db_query-Tool verwenden:

{
  "sql": "SELECT name, category, price FROM products ORDER BY price DESC LIMIT 5"
}

API-Aufruf — Wetterdaten abrufen

Fragen Sie Claude:

"Wie ist das aktuelle Wetter in San Francisco?"

Claude wird das api_call-Tool verwenden:

{
  "url": "https://api.open-meteo.com/v1/forecast?latitude=37.7749&longitude=-122.4194&current_weather=true",
  "method": "GET"
}

Dateioperationen

Fragen Sie Claude:

"Liste alle TypeScript-Dateien in meinem Projekt auf und lies dann den Haupteinstiegspunkt."

Claude wird file_list → file_read verketten:

{ "dirPath": "/path/to/project", "extension": ".ts", "recursive": true }
{ "filePath": "/path/to/project/src/index.ts" }

JSON-Parsing

Fragen Sie Claude:

"Analysiere dieses JSON und extrahiere die E-Mail des ersten Benutzers: {"users":[{"email":"alice@example.com"},{"email":"bob@example.com"}]}"

{
  "json": "{\"users\":[{\"email\":\"alice@example.com\"}]}",
  "operation": "query",
  "path": "users[0].email"
}

Texttransformation

Fragen Sie Claude:

"Konvertiere dies in camelCase und Slug: 'My Project Name'"

{ "text": "My Project Name", "operation": "camelcase" }
// → "myProjectName"

{ "text": "My Project Name", "operation": "slug" }
// → "my-project-name"

Architektur

mcp-toolkit-server/
├── src/
│   ├── index.ts                  # Entry point — creates and starts the MCP server
│   ├── tools/
│   │   ├── db-query.ts           # SQLite query tool (explore + file modes)
│   │   ├── api-call.ts           # HTTP request tool (fetch-based)
│   │   ├── file-operations.ts    # file_read, file_write, file_list
│   │   ├── calculator.ts         # Safe math expression evaluator
│   │   ├── datetime.ts           # Date/time with timezone support
│   │   ├── json-parser.ts        # Parse, query, validate, summarize JSON
│   │   ├── text-transform.ts     # 17+ text manipulation operations
│   │   └── environment.ts        # System environment info
│   └── utils/
│       └── helpers.ts            # Shared response-building utilities
├── tests/
│   └── tools.test.ts             # Unit tests (vitest)
├── package.json
├── tsconfig.json
└── README.md

Designprinzipien

1. Sicherheit zuerst — SQL-Injection-Prävention, kein eval(), schreibgeschützte Standardeinstellungen für Datenbankabfragen

2. Modular — Jedes Tool ist ein in sich geschlossenes Modul; einfaches Hinzufügen/Entfernen von Tools

3. Typisiert — Vollständiges TypeScript mit Zod-Schemas für die Eingabevalidierung

4. Beobachtbar — Strukturierte JSON-Antworten mit Metadaten (Zeit, Anzahl, Typen)

5. Entwicklerfreundlich — Unterstützung für MCP Inspector, umfassende README, Unit-Tests

Eigene Tools hinzufügen

Das Hinzufügen eines neuen Tools ist unkompliziert:

// src/tools/my-custom-tool.ts
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { z } from "zod";

export function registerMyCustomTool(server: McpServer): void {
  server.tool(
    "my_custom_tool",
    "Description of what this tool does.",
    {
      param1: z.string().describe("First parameter."),
      param2: z.number().optional().describe("Optional second parameter."),
    },
    async ({ param1, param2 }) => {
      // Your logic here
      return {
        content: [
          { type: "text", text: JSON.stringify({ result: "..." }, null, 2) },
        ],
      };
    }
  );
}

Registrieren Sie es dann in src/index.ts:

import { registerMyCustomTool } from "./tools/my-custom-tool.js";
// ...
registerMyCustomTool(this.server);

Entwicklung

# Run in development mode (no build step needed)
npm run dev

# Build for production
npm run build

# Run tests
npm test

# Watch tests
npm run test:watch

# Lint
npm run lint

Warum das wichtig ist: Die Agentic AI-Welle

MCP (Model Context Protocol) ist der offene Standard, der es KI-Agenten wie Claude ermöglicht, mit externen Tools, Datenquellen und Diensten zu interagieren. Anstatt auf ein Chat-Fenster beschränkt zu sein, geben MCP-Server Agenten die Fähigkeit:

• Datenbanken mit natürlicher Sprache abzufragen

• Externe APIs aufzurufen, um Echtzeitdaten abzurufen

• Dateien auf dem lokalen Dateisystem zu lesen und zu schreiben

• Berechnungen und Datentransformationen durchzuführen

• Mehrstufige Workflows durch die Verkettung von Tools zu erstellen

Dieser Server ist eine konkrete, produktionsreife Implementierung dieser Vision – ein Toolkit, das Claude von einer konversationellen KI in einen handlungsfähigen Agenten verwandelt, der mit der realen Welt interagieren kann.

Lizenz

MIT-Lizenz. Siehe LICENSE für Details.