chord-mcp 1.0.0

package/README.md

@@ -0,0 +1,21 @@
+# Chord MCP
+
+Build chords and scales from note names locally using music theory. No network, no key.
+
+This file is self contained. It reads public data only and never writes to the machine. All output is bounded and honest about what could not be fetched.
+
+## Tools
+
+
+* `chord_notes`  Notes of a chord.
+* `scale_notes`  Notes of a scale.
+
+## Usage
+
+```bash
+npm install
+npm run build
+node dist/index.js
+```
+
+All music theory runs locally.

package/dist/api.js

@@ -0,0 +1,44 @@
+export class ChordError extends Error {
+}
+const NOTES = ["C", "C#", "D", "D#", "E", "F", "F#", "G", "G#", "A", "A#", "B"];
+const ALIAS = { Db: "C#", Eb: "D#", Gb: "F#", Ab: "G#", Bb: "A#", "Cb": "B", "F#": "F#", "E#": "F" };
+const CHORDS = {
+    maj: [0, 4, 7], min: [0, 3, 7], "7": [0, 4, 7, 10], maj7: [0, 4, 7, 11], min7: [0, 3, 7, 10],
+    dim: [0, 3, 6], aug: [0, 4, 8], sus2: [0, 2, 7], sus4: [0, 5, 7], "6": [0, 4, 7, 9], min6: [0, 3, 7, 9],
+};
+const SCALES = {
+    major: [0, 2, 4, 5, 7, 9, 11], minor: [0, 2, 3, 5, 7, 8, 10], dorian: [0, 2, 3, 5, 7, 9, 10],
+    phrygian: [0, 1, 3, 5, 7, 8, 10], lydian: [0, 2, 4, 6, 7, 9, 11], mixolydian: [0, 2, 4, 5, 7, 9, 10],
+    locrian: [0, 1, 3, 5, 6, 8, 10], harmonic_minor: [0, 2, 3, 5, 7, 8, 11], pentatonic: [0, 2, 4, 7, 9],
+};
+function rootIndex(root) {
+    const r = ALIAS[root] ?? root;
+    const i = NOTES.indexOf(r);
+    if (i < 0)
+        throw new ChordError(`Unknown root note ${root}`);
+    return i;
+}
+export async function chordNotes(args) {
+    const root = (args.root ?? "").trim();
+    if (!root)
+        throw new ChordError("Provide a root note like C or F#");
+    const type = (args.chord ?? "maj").toLowerCase();
+    const intervals = CHORDS[type];
+    if (!intervals)
+        throw new ChordError(`Unknown chord type ${type}. Use ${Object.keys(CHORDS).join(", ")}`);
+    const r = rootIndex(root);
+    const notes = intervals.map((iv) => NOTES[(r + iv) % 12]);
+    return `${root}${type === "maj" ? "" : type}: ${notes.join(" - ")}`;
+}
+export async function scaleNotes(args) {
+    const root = (args.root ?? "").trim();
+    if (!root)
+        throw new ChordError("Provide a root note");
+    const scale = (args.scale ?? "major").toLowerCase();
+    const intervals = SCALES[scale];
+    if (!intervals)
+        throw new ChordError(`Unknown scale ${scale}. Use ${Object.keys(SCALES).join(", ")}`);
+    const r = rootIndex(root);
+    const notes = intervals.map((iv) => NOTES[(r + iv) % 12]);
+    return `${root} ${scale}: ${notes.join(" - ")}`;
+}

package/dist/index.js

@@ -0,0 +1,4 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+const main = async () => { const server = createServer(); await server.connect(new StdioServerTransport()); };
+main().catch((error) => { console.error("Fatal error:", error); process.exit(1); });

package/dist/server.js

@@ -0,0 +1,38 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { chordNotes } from "./api.js";
+import { scaleNotes } from "./api.js";
+const text = (value) => ({ content: [{ type: "text", text: value }] });
+const textError = (t) => ({ content: [{ type: "text", text: t }], isError: true });
+const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
+const error = (e) => `Error: ${e instanceof Error ? e.message : String(e)}`;
+export function createServer() {
+    const server = new McpServer({ name: "chord-mcp", version: "1.0.0" });
+    server.registerTool("chord_notes", {
+        title: "Chord notes",
+        description: "Get the notes of a chord.",
+        inputSchema: z.object({ root: z.string().describe("Root note like C or F#."), chord: z.string().describe("Chord type like maj, min, 7.").optional() }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await chordNotes(args));
+        }
+        catch (e) {
+            return textError(error(e));
+        }
+    });
+    server.registerTool("scale_notes", {
+        title: "Scale notes",
+        description: "Get the notes of a scale.",
+        inputSchema: z.object({ root: z.string().describe("Root note."), scale: z.string().describe("Scale like major or minor.").optional() }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await scaleNotes(args));
+        }
+        catch (e) {
+            return textError(error(e));
+        }
+    });
+    return server;
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "version": "1.0.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mrfentmen/chord-mcp.git"
+  },
+  "bin": {
+    "chord-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "server.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "dev": "npm run build && node dist/index.js"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.8",
+    "js-yaml": "^4.1.0",
+    "marked": "^14.0.0",
+    "turndown": "^7.2.0",
+    "diff": "^7.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "name": "chord-mcp",
+  "description": "Build chords and scales from note names locally. No network and no key.",
+  "mcpName": "io.github.mrfentmen/chord-mcp",
+  "keywords": [
+    "mcp",
+    "chord",
+    "music",
+    "scale",
+    "theory"
+  ],
+  "engines": {
+    "node": ">=20"
+  }
+}

package/server.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.mrfentmen/chord-mcp",
+  "description": "Build chords and scales from note names locally. No network and no key.",
+  "repository": {
+    "url": "https://github.com/mrfentmen/chord-mcp",
+    "source": "github"
+  },
+  "version": "1.0.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "chord-mcp",
+      "version": "1.0.0",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}