@originalvoices/mcp-server 1.0.0

package/README.md

@@ -0,0 +1,99 @@
+# OriginalVoices MCP Server
+
+An MCP (Model Context Protocol) server that provides access to [OriginalVoices](https://originalvoices.ai) AI twins for audience research.
+
+## Installation
+
+```bash
+npm install @originalvoices/mcp-server
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| `ORIGINALVOICES_API_KEY` | Your OriginalVoices API key | Yes |
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "originalvoices": {
+      "command": "npx",
+      "args": ["@originalvoices/mcp-server"],
+      "env": {
+        "ORIGINALVOICES_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+### From Source
+
+```json
+{
+  "mcpServers": {
+    "originalvoices": {
+      "command": "node",
+      "args": ["/path/to/ov-mcp-server/dist/index.js"],
+      "env": {
+        "ORIGINALVOICES_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+### ask_twins
+
+Ask questions to a specific audience using OriginalVoices AI twins.
+
+**Parameters:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `audience` | string | Description of the audience |
+| `questions` | string[] | Array of questions to ask the audience |
+
+**Example:**
+
+```json
+{
+  "audience": "Software developers aged 25-40 in the US",
+  "questions": [
+    "What is your biggest frustration with current dev tools?",
+    "How do you discover new tools and frameworks?"
+  ]
+}
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+```
+
+## FAQ
+
+### How do I get an API key?
+
+You can create an API key on the [OriginalVoices Platform](https://platform.originalvoices.ai).
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import OriginalVoices from "originalvoices";
+const server = new McpServer({
+    name: "originalvoices",
+    version: "1.0.0",
+});
+const client = new OriginalVoices({
+    apiKey: process.env.ORIGINALVOICES_API_KEY,
+});
+server.tool("ask_twins", "Ask questions to a specific audience using Original Voices AI twins", {
+    audience: z.string().describe("Description of the audience"),
+    questions: z.array(z.string()).describe("Array of questions to ask the audience"),
+}, async ({ audience, questions }) => {
+    const response = await client.ask.open({
+        questions,
+        audiencePrompt: audience,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response.data, null, 2),
+            },
+        ],
+    };
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(console.error);

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@originalvoices/mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for Original Voices - Ask AI twins questions about any audience",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "originalvoices-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "originalvoices",
+    "ai",
+    "twins",
+    "audience-research"
+  ],
+  "author": "Original Voices",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/originalvoices/mcp-server.git"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "originalvoices": "^0.11.0",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.8",
+    "typescript": "^5.9.3"
+  }
+}