german-rhymes-mcp 1.0.0

package/README.md

@@ -0,0 +1,131 @@
+# German Rhymes MCP Server 🎤
+
+An MCP (Model Context Protocol) server that provides German rhyme search capabilities using the [double-rhyme.com](https://double-rhyme.com/) API.
+
+## Features
+
+- 🔍 **Find Rhymes**: Search for German rhymes for any word or phrase
+- 🎯 **Double Rhymes**: Support for multi-word phrases (Doppelreime)
+- 📊 **Multiple Match Types**: Exact rhymes, vowel matches, ending rhymes
+- 🚀 **No Authentication Required**: The underlying API needs no API key
+- 💨 **Fast**: Simple GET requests to the API
+
+## Installation
+
+```bash
+cd rhyme-mcp
+pnpm install
+pnpm build
+```
+
+## Usage with Cursor
+
+Add to your Cursor settings (`~/.cursor/mcp.json` or Cursor Settings → MCP):
+
+```json
+{
+  "mcpServers": {
+    "german-rhymes": {
+      "command": "node",
+      "args": ["/path/to/rhyme-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+Or for development:
+
+```json
+{
+  "mcpServers": {
+    "german-rhymes": {
+      "command": "npx",
+      "args": ["tsx", "/path/to/rhyme-mcp/src/index.ts"]
+    }
+  }
+}
+```
+
+## Available Tools
+
+### `find_rhymes`
+
+Finds German rhymes for a word or phrase with detailed output.
+
+**Parameters:**
+- `word` (required): The word or phrase to find rhymes for
+- `match_type` (optional): Type of matching - `best` (default), `vowel`, or `ending`
+- `limit` (optional): Maximum number of rhymes to return
+
+**Example:**
+```
+Find rhymes for "Liebe"
+Find rhymes for "kiefer knochen" (double rhyme)
+```
+
+### `find_rhymes_json`
+
+Same as `find_rhymes` but returns JSON output for programmatic use.
+
+### `quick_rhymes`
+
+Quick rhyme suggestions - returns only the best rhymes as a simple list.
+
+**Parameters:**
+- `word` (required): The word to find rhymes for
+- `count` (optional): Number of rhymes (default: 10)
+
+## Example Output
+
+```
+🎤 Reime für "Haus"
+
+Gefunden: 48 Reime insgesamt
+
+✨ **Exakte Reime** (10):
+aus, raus, draus, maus, baus, strauß, graus, braus, staus, blaus
+
+🎯 **Kuratierte Reime** (3):
+schmaus, laus, kraus
+
+📝 **Ähnliche Reime** (15):
+applaus, voraus, hinaus, heraus, daraus, durchaus, hieraus...
+
+🔊 **Vokal-Übereinstimmungen** (20):
+auf, auch, drauf, glaub, schau, sound, faust, raum...
+```
+
+## Development
+
+```bash
+# Run in development mode
+pnpm dev
+
+# Build for production
+pnpm build
+
+# Watch mode
+pnpm watch
+```
+
+## API Reference
+
+This MCP server uses the double-rhyme.com API:
+
+```
+GET https://us-central1-double-rhyme-website.cloudfunctions.net/rhyme-proxy
+  ?searchterm=<word>
+  &language=de
+  &matchType=vowel_rhyme_consonantal_ending
+  &genre=rap
+```
+
+**Match Types:**
+- `vowel_rhyme_consonantal_ending` - Best for rap/poetry
+- `vowel_rhyme` - Vowel sound matches only
+- `ending_rhyme` - Traditional end rhymes
+
+## License
+
+MIT
+

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,228 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+// API Configuration
+const API_URL = "https://us-central1-double-rhyme-website.cloudfunctions.net/rhyme-proxy";
+/**
+ * Fetch rhymes from the double-rhyme.com API
+ */
+async function fetchRhymes(searchTerm, matchType = "vowel_rhyme_consonantal_ending") {
+    const params = new URLSearchParams({
+        searchterm: searchTerm,
+        language: "de",
+        matchType,
+        genre: "rap",
+    });
+    const response = await fetch(`${API_URL}?${params}`);
+    if (!response.ok) {
+        throw new Error(`API request failed: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    if (data.errors) {
+        throw new Error(`API error: ${data.errors}`);
+    }
+    const results = data.typeToResultMap || {};
+    const exactRhymes = results.ending2 || [];
+    const closeRhymes = results.ending1 || [];
+    const vowelMatches = results.v || [];
+    const curatedRhymes = results.custom || [];
+    const userSubmitted = results.user || [];
+    // Combine all rhymes and deduplicate
+    const allRhymes = [...new Set([
+            ...exactRhymes,
+            ...curatedRhymes,
+            ...closeRhymes,
+            ...vowelMatches,
+            ...userSubmitted,
+        ])];
+    return {
+        exactRhymes,
+        closeRhymes,
+        vowelMatches,
+        curatedRhymes,
+        userSubmitted,
+        allRhymes,
+    };
+}
+/**
+ * Format rhyme results for display
+ */
+function formatRhymeResults(word, results) {
+    const sections = [];
+    sections.push(`🎤 Reime für "${word}"\n`);
+    sections.push(`Gefunden: ${results.allRhymes.length} Reime insgesamt\n`);
+    if (results.exactRhymes.length > 0) {
+        sections.push(`\n✨ **Exakte Reime** (${results.exactRhymes.length}):`);
+        sections.push(results.exactRhymes.slice(0, 20).join(", "));
+        if (results.exactRhymes.length > 20) {
+            sections.push(`... und ${results.exactRhymes.length - 20} weitere`);
+        }
+    }
+    if (results.curatedRhymes.length > 0) {
+        sections.push(`\n🎯 **Kuratierte Reime** (${results.curatedRhymes.length}):`);
+        sections.push(results.curatedRhymes.slice(0, 15).join(", "));
+    }
+    if (results.closeRhymes.length > 0) {
+        sections.push(`\n📝 **Ähnliche Reime** (${results.closeRhymes.length}):`);
+        sections.push(results.closeRhymes.slice(0, 15).join(", "));
+        if (results.closeRhymes.length > 15) {
+            sections.push(`... und ${results.closeRhymes.length - 15} weitere`);
+        }
+    }
+    if (results.vowelMatches.length > 0) {
+        sections.push(`\n🔊 **Vokal-Übereinstimmungen** (${results.vowelMatches.length}):`);
+        sections.push(results.vowelMatches.slice(0, 20).join(", "));
+        if (results.vowelMatches.length > 20) {
+            sections.push(`... und ${results.vowelMatches.length - 20} weitere`);
+        }
+    }
+    if (results.userSubmitted.length > 0) {
+        sections.push(`\n👥 **Community Reime** (${results.userSubmitted.length}):`);
+        sections.push(results.userSubmitted.slice(0, 10).join(", "));
+    }
+    return sections.join("\n");
+}
+// Create the MCP server
+const server = new McpServer({
+    name: "german-rhymes",
+    version: "1.0.0",
+});
+// Register the rhyme search tool
+server.tool("find_rhymes", "Findet deutsche Reime für ein Wort oder eine Phrase. Unterstützt auch Doppelreime (mehrere Wörter).", {
+    word: z.string().describe("Das Wort oder die Phrase, für die Reime gesucht werden sollen"),
+    match_type: z.enum(["best", "vowel", "ending"]).optional().describe("Art der Reim-Übereinstimmung: 'best' (Standard, beste Ergebnisse), 'vowel' (nur Vokalübereinstimmung), 'ending' (nur Endreime)"),
+    limit: z.number().optional().describe("Maximale Anzahl der zurückgegebenen Reime (Standard: alle)"),
+}, async ({ word, match_type, limit }) => {
+    try {
+        // Map match_type to API matchType
+        const matchTypeMap = {
+            best: "vowel_rhyme_consonantal_ending",
+            vowel: "vowel_rhyme",
+            ending: "ending_rhyme",
+        };
+        const apiMatchType = matchTypeMap[match_type || "best"] || "vowel_rhyme_consonantal_ending";
+        const results = await fetchRhymes(word, apiMatchType);
+        // Apply limit if specified
+        if (limit && limit > 0) {
+            results.allRhymes = results.allRhymes.slice(0, limit);
+            results.exactRhymes = results.exactRhymes.slice(0, Math.ceil(limit / 3));
+            results.vowelMatches = results.vowelMatches.slice(0, Math.ceil(limit / 3));
+            results.closeRhymes = results.closeRhymes.slice(0, Math.ceil(limit / 3));
+        }
+        const formattedOutput = formatRhymeResults(word, results);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formattedOutput,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Unbekannter Fehler";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ Fehler beim Suchen von Reimen für "${word}": ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Register a tool to get rhymes as JSON (for programmatic use)
+server.tool("find_rhymes_json", "Findet deutsche Reime und gibt sie als JSON zurück (für programmatische Verwendung).", {
+    word: z.string().describe("Das Wort oder die Phrase, für die Reime gesucht werden sollen"),
+    match_type: z.enum(["best", "vowel", "ending"]).optional().describe("Art der Reim-Übereinstimmung"),
+}, async ({ word, match_type }) => {
+    try {
+        const matchTypeMap = {
+            best: "vowel_rhyme_consonantal_ending",
+            vowel: "vowel_rhyme",
+            ending: "ending_rhyme",
+        };
+        const apiMatchType = matchTypeMap[match_type || "best"] || "vowel_rhyme_consonantal_ending";
+        const results = await fetchRhymes(word, apiMatchType);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        query: word,
+                        matchType: match_type || "best",
+                        results: {
+                            exactRhymes: results.exactRhymes,
+                            closeRhymes: results.closeRhymes,
+                            vowelMatches: results.vowelMatches,
+                            curatedRhymes: results.curatedRhymes,
+                            userSubmitted: results.userSubmitted,
+                            total: results.allRhymes.length,
+                        },
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Unbekannter Fehler";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ error: errorMessage, query: word }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Register a tool for quick rhyme suggestions (concise output)
+server.tool("quick_rhymes", "Schnelle Reim-Vorschläge - gibt nur die besten Reime als Liste zurück.", {
+    word: z.string().describe("Das Wort für das Reime gesucht werden"),
+    count: z.number().optional().describe("Anzahl der Reime (Standard: 10)"),
+}, async ({ word, count }) => {
+    try {
+        const results = await fetchRhymes(word);
+        const limit = count || 10;
+        // Get the best rhymes (prioritize exact, then curated, then close)
+        const bestRhymes = [
+            ...results.exactRhymes,
+            ...results.curatedRhymes,
+            ...results.closeRhymes,
+        ].slice(0, limit);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Reime für "${word}": ${bestRhymes.join(", ")}`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Unbekannter Fehler";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Fehler: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Main function to start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("German Rhymes MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Failed to start server:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "german-rhymes-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for finding German rhymes using double-rhyme.com API",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "german-rhymes-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "watch": "tsc --watch"
+  },
+  "keywords": [
+    "mcp",
+    "rhymes",
+    "german",
+    "poetry",
+    "rap"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}
+

package/src/index.ts

@@ -0,0 +1,304 @@
+#!/usr/bin/env node
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+// Types for the API response
+interface RhymeApiResponse {
+  typeToResultMap: {
+    ending2?: string[];  // Best exact rhymes
+    ending1?: string[];  // Close ending matches
+    v?: string[];        // Vowel sound matches
+    custom?: string[];   // Curated rhymes
+    user?: string[];     // User-submitted rhymes
+  };
+  requestType: string;
+  errors: string | null;
+}
+
+interface RhymeResult {
+  exactRhymes: string[];
+  closeRhymes: string[];
+  vowelMatches: string[];
+  curatedRhymes: string[];
+  userSubmitted: string[];
+  allRhymes: string[];
+}
+
+// API Configuration
+const API_URL = "https://us-central1-double-rhyme-website.cloudfunctions.net/rhyme-proxy";
+
+type MatchType = "vowel_rhyme_consonantal_ending" | "vowel_rhyme" | "ending_rhyme";
+
+/**
+ * Fetch rhymes from the double-rhyme.com API
+ */
+async function fetchRhymes(
+  searchTerm: string,
+  matchType: MatchType = "vowel_rhyme_consonantal_ending"
+): Promise<RhymeResult> {
+  const params = new URLSearchParams({
+    searchterm: searchTerm,
+    language: "de",
+    matchType,
+    genre: "rap",
+  });
+
+  const response = await fetch(`${API_URL}?${params}`);
+
+  if (!response.ok) {
+    throw new Error(`API request failed: ${response.status} ${response.statusText}`);
+  }
+
+  const data: RhymeApiResponse = await response.json();
+
+  if (data.errors) {
+    throw new Error(`API error: ${data.errors}`);
+  }
+
+  const results = data.typeToResultMap || {};
+
+  const exactRhymes = results.ending2 || [];
+  const closeRhymes = results.ending1 || [];
+  const vowelMatches = results.v || [];
+  const curatedRhymes = results.custom || [];
+  const userSubmitted = results.user || [];
+
+  // Combine all rhymes and deduplicate
+  const allRhymes = [...new Set([
+    ...exactRhymes,
+    ...curatedRhymes,
+    ...closeRhymes,
+    ...vowelMatches,
+    ...userSubmitted,
+  ])];
+
+  return {
+    exactRhymes,
+    closeRhymes,
+    vowelMatches,
+    curatedRhymes,
+    userSubmitted,
+    allRhymes,
+  };
+}
+
+/**
+ * Format rhyme results for display
+ */
+function formatRhymeResults(word: string, results: RhymeResult): string {
+  const sections: string[] = [];
+
+  sections.push(`🎤 Reime für "${word}"\n`);
+  sections.push(`Gefunden: ${results.allRhymes.length} Reime insgesamt\n`);
+
+  if (results.exactRhymes.length > 0) {
+    sections.push(`\n✨ **Exakte Reime** (${results.exactRhymes.length}):`);
+    sections.push(results.exactRhymes.slice(0, 20).join(", "));
+    if (results.exactRhymes.length > 20) {
+      sections.push(`... und ${results.exactRhymes.length - 20} weitere`);
+    }
+  }
+
+  if (results.curatedRhymes.length > 0) {
+    sections.push(`\n🎯 **Kuratierte Reime** (${results.curatedRhymes.length}):`);
+    sections.push(results.curatedRhymes.slice(0, 15).join(", "));
+  }
+
+  if (results.closeRhymes.length > 0) {
+    sections.push(`\n📝 **Ähnliche Reime** (${results.closeRhymes.length}):`);
+    sections.push(results.closeRhymes.slice(0, 15).join(", "));
+    if (results.closeRhymes.length > 15) {
+      sections.push(`... und ${results.closeRhymes.length - 15} weitere`);
+    }
+  }
+
+  if (results.vowelMatches.length > 0) {
+    sections.push(`\n🔊 **Vokal-Übereinstimmungen** (${results.vowelMatches.length}):`);
+    sections.push(results.vowelMatches.slice(0, 20).join(", "));
+    if (results.vowelMatches.length > 20) {
+      sections.push(`... und ${results.vowelMatches.length - 20} weitere`);
+    }
+  }
+
+  if (results.userSubmitted.length > 0) {
+    sections.push(`\n👥 **Community Reime** (${results.userSubmitted.length}):`);
+    sections.push(results.userSubmitted.slice(0, 10).join(", "));
+  }
+
+  return sections.join("\n");
+}
+
+// Create the MCP server
+const server = new McpServer({
+  name: "german-rhymes",
+  version: "1.0.0",
+});
+
+// Register the rhyme search tool
+server.tool(
+  "find_rhymes",
+  "Findet deutsche Reime für ein Wort oder eine Phrase. Unterstützt auch Doppelreime (mehrere Wörter).",
+  {
+    word: z.string().describe("Das Wort oder die Phrase, für die Reime gesucht werden sollen"),
+    match_type: z.enum(["best", "vowel", "ending"]).optional().describe(
+      "Art der Reim-Übereinstimmung: 'best' (Standard, beste Ergebnisse), 'vowel' (nur Vokalübereinstimmung), 'ending' (nur Endreime)"
+    ),
+    limit: z.number().optional().describe("Maximale Anzahl der zurückgegebenen Reime (Standard: alle)"),
+  },
+  async ({ word, match_type, limit }) => {
+    try {
+      // Map match_type to API matchType
+      const matchTypeMap: Record<string, MatchType> = {
+        best: "vowel_rhyme_consonantal_ending",
+        vowel: "vowel_rhyme",
+        ending: "ending_rhyme",
+      };
+
+      const apiMatchType = matchTypeMap[match_type || "best"] || "vowel_rhyme_consonantal_ending";
+
+      const results = await fetchRhymes(word, apiMatchType);
+
+      // Apply limit if specified
+      if (limit && limit > 0) {
+        results.allRhymes = results.allRhymes.slice(0, limit);
+        results.exactRhymes = results.exactRhymes.slice(0, Math.ceil(limit / 3));
+        results.vowelMatches = results.vowelMatches.slice(0, Math.ceil(limit / 3));
+        results.closeRhymes = results.closeRhymes.slice(0, Math.ceil(limit / 3));
+      }
+
+      const formattedOutput = formatRhymeResults(word, results);
+
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: formattedOutput,
+          },
+        ],
+      };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : "Unbekannter Fehler";
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: `❌ Fehler beim Suchen von Reimen für "${word}": ${errorMessage}`,
+          },
+        ],
+        isError: true,
+      };
+    }
+  }
+);
+
+// Register a tool to get rhymes as JSON (for programmatic use)
+server.tool(
+  "find_rhymes_json",
+  "Findet deutsche Reime und gibt sie als JSON zurück (für programmatische Verwendung).",
+  {
+    word: z.string().describe("Das Wort oder die Phrase, für die Reime gesucht werden sollen"),
+    match_type: z.enum(["best", "vowel", "ending"]).optional().describe("Art der Reim-Übereinstimmung"),
+  },
+  async ({ word, match_type }) => {
+    try {
+      const matchTypeMap: Record<string, MatchType> = {
+        best: "vowel_rhyme_consonantal_ending",
+        vowel: "vowel_rhyme",
+        ending: "ending_rhyme",
+      };
+
+      const apiMatchType = matchTypeMap[match_type || "best"] || "vowel_rhyme_consonantal_ending";
+
+      const results = await fetchRhymes(word, apiMatchType);
+
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: JSON.stringify({
+              query: word,
+              matchType: match_type || "best",
+              results: {
+                exactRhymes: results.exactRhymes,
+                closeRhymes: results.closeRhymes,
+                vowelMatches: results.vowelMatches,
+                curatedRhymes: results.curatedRhymes,
+                userSubmitted: results.userSubmitted,
+                total: results.allRhymes.length,
+              },
+            }, null, 2),
+          },
+        ],
+      };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : "Unbekannter Fehler";
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: JSON.stringify({ error: errorMessage, query: word }, null, 2),
+          },
+        ],
+        isError: true,
+      };
+    }
+  }
+);
+
+// Register a tool for quick rhyme suggestions (concise output)
+server.tool(
+  "quick_rhymes",
+  "Schnelle Reim-Vorschläge - gibt nur die besten Reime als Liste zurück.",
+  {
+    word: z.string().describe("Das Wort für das Reime gesucht werden"),
+    count: z.number().optional().describe("Anzahl der Reime (Standard: 10)"),
+  },
+  async ({ word, count }) => {
+    try {
+      const results = await fetchRhymes(word);
+      const limit = count || 10;
+      
+      // Get the best rhymes (prioritize exact, then curated, then close)
+      const bestRhymes = [
+        ...results.exactRhymes,
+        ...results.curatedRhymes,
+        ...results.closeRhymes,
+      ].slice(0, limit);
+
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: `Reime für "${word}": ${bestRhymes.join(", ")}`,
+          },
+        ],
+      };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : "Unbekannter Fehler";
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: `Fehler: ${errorMessage}`,
+          },
+        ],
+        isError: true,
+      };
+    }
+  }
+);
+
+// Main function to start the server
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("German Rhymes MCP Server running on stdio");
+}
+
+main().catch((error) => {
+  console.error("Failed to start server:", error);
+  process.exit(1);
+});
+

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}
+