idiolect-mcp 0.1.0

package/README.md

@@ -0,0 +1,32 @@
+# idiolect-mcp
+
+MCP server that makes any MCP-compatible AI (Claude Desktop, Claude Code, …)
+write in **your** voice, using your [Idiolect](https://idiolect.lol) Voice Card.
+
+## Setup
+
+1. Get your voice at **https://idiolect.lol** — note the slug in your result URL
+   (`idiolect.lol/v/<slug>`).
+2. Add to your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "idiolect": {
+      "command": "npx",
+      "args": ["-y", "idiolect-mcp"],
+      "env": { "IDIOLECT_SLUG": "your-slug" }
+    }
+  }
+}
+```
+
+## Tool
+
+- **`get_my_voice`** — returns your Voice Card. The model calls it before writing
+  on your behalf, then writes as you. Pass `slug` per-call or set `IDIOLECT_SLUG`.
+
+Set `IDIOLECT_BASE` to point at a self-hosted instance (defaults to
+`https://idiolect.lol`).
+
+MIT licensed.

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "idiolect-mcp",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": { "idiolect-mcp": "server.mjs" },
+  "description": "MCP server that gives any MCP-compatible AI (Claude, etc.) your Idiolect voice — make AI write as you. https://idiolect.lol",
+  "keywords": ["mcp", "model-context-protocol", "claude", "ai", "writing", "voice", "idiolect"],
+  "homepage": "https://idiolect.lol",
+  "repository": { "type": "git", "url": "https://github.com/111mihir/idiolect.git", "directory": "mcp" },
+  "license": "MIT",
+  "files": ["server.mjs", "README.md"],
+  "engines": { "node": ">=18" },
+  "publishConfig": { "access": "public" },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4"
+  }
+}

package/server.mjs

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+// Idiolect MCP server — gives any MCP-compatible AI (Claude Desktop, Claude
+// Code, etc.) your personal voice. Configure with your Voice Card slug:
+//
+//   {
+//     "mcpServers": {
+//       "idiolect": {
+//         "command": "node",
+//         "args": ["/path/to/idiolect/mcp/server.mjs"],
+//         "env": { "IDIOLECT_SLUG": "your-slug", "IDIOLECT_BASE": "https://idiolect.lol" }
+//       }
+//     }
+//   }
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+const BASE = process.env.IDIOLECT_BASE || "https://idiolect.lol";
+const DEFAULT_SLUG = process.env.IDIOLECT_SLUG || "";
+
+async function fetchVoice(slug) {
+  const res = await fetch(`${BASE}/api/voice/${encodeURIComponent(slug)}`);
+  if (!res.ok) throw new Error(`Idiolect: voice "${slug}" not found (${res.status})`);
+  return res.json();
+}
+
+const server = new Server(
+  { name: "idiolect", version: "0.1.0" },
+  { capabilities: { tools: {} } },
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: "get_my_voice",
+      description:
+        "Load the user's Idiolect Voice Card. Call this BEFORE writing anything on the user's behalf (emails, posts, messages, docs) and then write strictly in the returned voice. Returns a style guide describing how the user actually writes.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          slug: {
+            type: "string",
+            description:
+              "Idiolect voice slug. Optional if IDIOLECT_SLUG is set in the server env.",
+          },
+        },
+      },
+    },
+  ],
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+  if (req.params.name !== "get_my_voice") {
+    throw new Error(`Unknown tool: ${req.params.name}`);
+  }
+  const slug = req.params.arguments?.slug || DEFAULT_SLUG;
+  if (!slug) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: "No Idiolect slug provided. Pass `slug` or set IDIOLECT_SLUG. Get yours at https://idiolect.lol",
+        },
+      ],
+      isError: true,
+    };
+  }
+  try {
+    const v = await fetchVoice(slug);
+    return {
+      content: [
+        {
+          type: "text",
+          text: `${v.voiceCard}\n\n---\n(Idiolect voice #${slug} · genericness ${v.genericnessScore}/100. Write everything as this person from now on.)`,
+        },
+      ],
+    };
+  } catch (e) {
+    return { content: [{ type: "text", text: String(e) }], isError: true };
+  }
+});
+
+const transport = new StdioServerTransport();
+await server.connect(transport);