DynamoDB schreibgeschütztes MCP

Name: DynamoDB Read-Only MCP
Author: jjikky

npm-Version Schmiedeabzeichen

Ein Server, der das Model Context Protocol (MCP) zur Abfrage von AWS DynamoDB-Datenbanken nutzt. Dieser Server ermöglicht LLMs wie Claude die Abfrage von DynamoDB-Daten über natürlichsprachliche Anfragen.

Merkmale

Dieser MCP-Server bietet die folgenden Funktionen:

Tools zur Tabellenverwaltung :
- list-tables : Eine Liste aller DynamoDB-Tabellen anzeigen
- describe-table : Detaillierte Informationen zu einer bestimmten Tabelle anzeigen
Datenabfragetools :
- scan-table : Scannen Sie alle oder einen Teil der Daten einer Tabelle
- query-table : Suche nach Daten, die bestimmten Bedingungen in einer Tabelle entsprechen
- paginate-query-table : Daten über mehrere Seiten abrufen, die bestimmten Bedingungen entsprechen
- get-item : Ruft ein Element mit einem bestimmten Schlüssel ab
- count-items : Berechnen Sie die Anzahl der Elemente in einer Tabelle
Ressourcen :
- dynamodb-tables-info : Eine Ressource, die Metadaten für alle Tabellen bereitstellt
- dynamodb-table-schema : Eine Ressource, die Schemainformationen für eine bestimmte Tabelle bereitstellt
Eingabeaufforderungen :
- dynamodb-query-help : Eine Hilfeaufforderung zum Schreiben von DynamoDB-Abfragen

Related MCP server: dbt Semantic Layer MCP Server

Installation und Ausführung

Sie können es ohne Installation ausführen, indem Sie die unten stehende Methode Run with NPX verwenden.

Installation über Smithery

So installieren Sie den DynamoDB Read-Only Server für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @jjikky/dynamo-readonly-mcp --client claude

Installation

Klonen Sie das Repository:
git clone https://github.com/jjikky/dynamo-readonly-mcp.git cd dynamo-readonly-mcp
Installieren Sie die erforderlichen Pakete:
npm install
Erstellen Sie eine .env Datei und richten Sie Ihre AWS-Anmeldeinformationen ein:
AWS_ACCESS_KEY_ID=your_access_key AWS_SECRET_ACCESS_KEY=your_secret_key AWS_REGION=your_region

Erstellen und Ausführen

npm run build npm start

Verbinden Sie sich mit Claude Desktop

Um diesen MCP-Server mit Claude Desktop zu verwenden, müssen Sie die Claude Desktop-Konfigurationsdatei ändern.

Öffnen Sie die Claude Desktop-Konfigurationsdatei:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Fügen Sie die Serverkonfiguration wie folgt hinzu:
{ "mcpServers": { "dynamodb-readonly": { "command": "node", "args": ["/absolute-path/dynamo-readonly-mcp/dist/index.js"], "env": { "AWS_ACCESS_KEY_ID": "your_access_key", "AWS_SECRET_ACCESS_KEY": "your_secret_key", "AWS_REGION": "your_region" } } } }
Starten Sie Claude Desktop neu.

Ausführen mit NPX

Sie können diesen Server auch ohne globale Installation mit npx ausführen:

{ "mcpServers": { "dynamodb-readonly": { "command": "npx", "args": ["-y", "dynamo-readonly-mcp"], "env": { "AWS_ACCESS_KEY_ID": "your_access_key", "AWS_SECRET_ACCESS_KEY": "your_secret_key", "AWS_REGION": "your_region" } } } }

Anwendungsbeispiele

Sie können Claude Fragen stellen wie:

„Können Sie mir sagen, welche Tabellen in DynamoDB sind?“
„Erklären Sie die Struktur der Benutzertabelle“
„Suchen Sie in der Tabelle ‚Benutzer‘ die Anzahl der Benutzer, deren Gruppen-ID ‚0lxp4paxk7‘ ist.“

Architektur

Dieser MCP-Server besteht aus der folgenden Schichtenstruktur:

Client-Schnittstelle (Claude Desktop) - Interaktion zwischen Benutzer und LLM
MCP-Protokollschicht - Bietet eine standardisierte Methode zum Nachrichtenaustausch
DynamoDB-Server – Implementiert Funktionen, die mit DynamoDB interagieren
AWS SDK – Kommuniziert mit dem AWS DynamoDB-Dienst

Wichtige Betriebsmechanismen

1. Initialisierung und Verbindung

Wenn der Server startet, läuft der folgende Prozess ab:

async function main() { const transport = new StdioServerTransport(); await server.connect(transport); console.error('DynamoDB read-only MCP server is running...'); }

StdioServerTransport richtet einen Kommunikationskanal über die Standardeingabe/-ausgabe ein.
server.connect(transport) stellt über das MCP-Protokoll eine Verbindung zu Claude Desktop her.
Während der Verbindung sendet der Server Informationen zu unterstützten Tools, Ressourcen und Eingabeaufforderungen an den Client.

2. Bearbeitung von Werkzeuganfragen

Wenn ein Benutzer Claude etwas fragt wie „Zeigen Sie mir die Liste der DynamoDB-Tabellen“:

Claude analysiert diese Anfrage und ruft das list-tables -Tool auf.
Diese Anfrage wird über das MCP-Protokoll an den Server gesendet.
Der Server führt den entsprechenden Tool-Handler aus:

server.tool('list-tables', 'Gets a list of all DynamoDB tables', {}, async () => { try { const tables = await listTables(); return { content: [{ type: 'text', text: JSON.stringify(tables, null, 2) }], }; } catch (error) { return { isError: true, content: [{ type: 'text', text: `Error: ${error.message}` }] }; } });

Das Ergebnis wird über das MCP-Protokoll an Claude zurückgegeben.
Claude verarbeitet dieses Ergebnis in natürlicher Sprache und präsentiert es dem Benutzer.

3. Spezifische Parameterbehandlung

Wenn ein Benutzer anfordert: „Sagen Sie mir die Struktur der Benutzertabelle“:

Claude legt fest, dass für diese Anfrage das Tool describe-table verwendet werden soll.
Claude konfiguriert den Parameter als { tableName: "Users" } .
Diese Informationen werden an den MCP-Server gesendet:

server.tool( 'describe-table', 'Gets detailed information about a DynamoDB table', { tableName: z.string().describe('Name of the table to get detailed information for'), }, async ({ tableName }) => { // Query table information using the tableName parameter const tableInfo = await describeTable(tableName); // Return results } );

Hier verwendet z.string() die Zod-Bibliothek zur Validierung von Parametern.

4. Ressourcenverwaltung

Ressourcen sind eine weitere MCP-Funktion, die schreibgeschützte Daten bereitstellt:

server.resource('dynamodb-tables-info', 'DynamoDB table information', async () => { // Create and return resource data const tables = await listTables(); const tablesInfo = await Promise.all(/* Query table information */); return { contents: [ { uri: 'dynamodb://tables-info', text: JSON.stringify(tablesInfo, null, 2), mimeType: 'application/json', }, ], }; });

Claude greift auf Ressourcen zu und verwendet sie als Kontextinformationen.

5. Schnelle Bearbeitung

Der MCP-Server kann Eingabeaufforderungsvorlagen für bestimmte Aufgaben bereitstellen:

server.prompt( 'dynamodb-query-help', 'A prompt that helps write DynamoDB queries', { tableName: z.string().describe('Table name to query'), queryType: z.enum(['basic', 'advanced']).default('basic'), }, async ({ tableName, queryType }) => { // Generate prompt content return { messages: [ { role: 'user', content: { type: 'text', text: helpContent }, }, ], }; } );

Diese Eingabeaufforderung wird verwendet, wenn ein Benutzer anfordert: „Zeigen Sie mir, wie ich Abfragen für die Benutzertabelle schreibe.“

Datenflusszusammenfassung

Der Benutzer stellt eine Anfrage an Claude in natürlicher Sprache
Claude analysiert die Anfrage und wählt das entsprechende MCP-Tool/die entsprechende Ressource/Eingabeaufforderung aus
Der MCP-Client sendet die Anfrage in einem standardisierten Format an den Server
Der Server verarbeitet die Anfrage und ruft die AWS DynamoDB-API auf
DynamoDB gibt Ergebnisse zurück
Der Server konvertiert die Ergebnisse in das MCP-Format und sendet sie an den Client
Claude verarbeitet die Ergebnisse in natürlicher Sprache und präsentiert sie dem Benutzer

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE.

DynamoDB Read-Only MCP