@echoes-io/mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 echoes-io
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,86 @@
+# mcp-server
+
+Model Context Protocol server for AI integration with Echoes storytelling platform
+
+## Installation
+
+The server is distributed as an npm package and can be used without cloning the repository.
+
+### Using with MCP Clients
+
+Add to your MCP client configuration (e.g., `~/.config/q/mcp.json` for Amazon Q):
+
+```json
+{
+  "mcpServers": {
+    "echoes": {
+      "command": "npx",
+      "args": ["-y", "@echoes-io/mcp-server"]
+    }
+  }
+}
+```
+
+Or install globally:
+
+```bash
+npm install -g @echoes-io/mcp-server
+```
+
+Then configure:
+
+```json
+{
+  "mcpServers": {
+    "echoes": {
+      "command": "echoes-mcp-server"
+    }
+  }
+}
+```
+
+## Usage
+
+Once configured, the server provides tools for:
+- Content management (chapters, episodes, arcs)
+- Word counting and text statistics
+- Database operations via @echoes-io/tracker
+- Timeline synchronization
+
+Available tools will be listed by your MCP client.
+
+## Development
+
+### Scripts
+
+```bash
+# Run tests
+npm test
+
+# Run tests with coverage
+npm run test:coverage
+
+# Build
+npm run build
+
+# Lint
+npm run lint
+
+# Fix linting issues
+npm run lint:fix
+```
+
+### Tech Stack
+
+- **Language**: TypeScript (strict mode)
+- **Testing**: Vitest
+- **Linting**: Biome
+- **Build**: TypeScript compiler
+
+## License
+
+MIT
+
+---
+
+Part of the [Echoes](https://github.com/echoes-io) project - a multi-POV digital storytelling platform.

package/cli/index.d.ts

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

package/cli/index.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { runServer } from '../lib/server.js';
+runServer().catch((error) => {
+    console.error('Server error:', error);
+    process.exit(1);
+});

package/lib/server.d.ts

@@ -0,0 +1,25 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export declare function createServer(): Server<{
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | undefined;
+}, {
+    [x: string]: unknown;
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+}>;
+export declare function runServer(): Promise<void>;

package/lib/server.js

@@ -0,0 +1,33 @@
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+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 __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
+export function createServer() {
+    const server = new Server({
+        name: pkg.name,
+        version: pkg.version,
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: [],
+        };
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        throw new Error(`Unknown tool: ${request.params.name}`);
+    });
+    return server;
+}
+export async function runServer() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('Echoes MCP Server running on stdio');
+}

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@echoes-io/mcp-server",
+  "type": "module",
+  "version": "1.0.0",
+  "description": "Model Context Protocol server for AI integration with Echoes storytelling platform",
+  "scripts": {
+    "dev": "tsx cli/index.ts",
+    "start": "node cli/index.js",
+    "lint": "concurrently npm:lint:* --prefixColors auto",
+    "lint:fix": "biome check --write",
+    "lint:lockfile": "lockfile-lint --path package-lock.json",
+    "lint:engines": "ls-engines",
+    "lint:publish": "publint --strict",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "prepare": "[ \"$CI\" = \"true\" ] || [ \"$GITHUB_ACTIONS\" = \"true\" ] && echo 'Skipping husky' && exit 0 || husky",
+    "clean": "rimraf --glob ./{cli,lib,test}/**/*.{d.ts,js} ./vitest*.{d.ts,js}",
+    "prebuild": "npm run clean",
+    "build": "tsc",
+    "release": "semantic-release"
+  },
+  "bin": {
+    "echoes-mcp-server": "./cli/index.js"
+  },
+  "exports": {
+    ".": "./lib/server.js"
+  },
+  "files": [
+    "cli/**/*.{d.ts,js}",
+    "lib/**/*.{d.ts,js}"
+  ],
+  "engines": {
+    "node": ">= 20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/echoes-io/mcp-server.git"
+  },
+  "keywords": [
+    "echoes",
+    "storytelling",
+    "multi-pov"
+  ],
+  "author": "Zweer <n.olivieriachille@gmail.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/echoes-io/mcp-server/issues"
+  },
+  "homepage": "https://github.com/echoes-io/mcp-server#readme",
+  "release": {
+    "plugins": [
+      "@semantic-release/commit-analyzer",
+      "@semantic-release/release-notes-generator",
+      "@semantic-release/changelog",
+      "@semantic-release/npm",
+      "@semantic-release/github",
+      "@semantic-release/git"
+    ]
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.2.7",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@tsconfig/node22": "^22.0.2",
+    "@types/node": "^24.9.1",
+    "@vitest/coverage-v8": "^3.2.4",
+    "concurrently": "^9.2.1",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.5",
+    "lockfile-lint": "^4.14.1",
+    "ls-engines": "^0.9.3",
+    "publint": "^0.3.15",
+    "rimraf": "^6.0.1",
+    "semantic-release": "^25.0.1",
+    "tsx": "^4.19.2",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "@echoes-io/utils": "^1.1.1",
+    "@echoes-io/models": "^1.0.0",
+    "@echoes-io/tracker": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  }
+}