@h-ear/mcp-server 0.1.0-dev.202603280915

package/README.md

@@ -0,0 +1,100 @@
+# @h-ear/mcp-server
+
+MCP server for the [H-ear World](https://h-ear.world) audio classification API. Connect Claude, ChatGPT, Copilot, and other AI agents to 521+ sound classes.
+
+## Quick Start
+
+```bash
+npx @h-ear/mcp-server --key ncm_sk_your_key
+```
+
+## Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "h-ear": {
+      "command": "npx",
+      "args": ["-y", "@h-ear/mcp-server"],
+      "env": { "HEAR_API_KEY": "ncm_sk_your_key" }
+    }
+  }
+}
+```
+
+## Claude Code
+
+Add to `.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "h-ear": {
+      "command": "npx",
+      "args": ["-y", "@h-ear/mcp-server"],
+      "env": { "HEAR_API_KEY": "ncm_sk_your_key" }
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Description | Auth |
+|------|-------------|------|
+| `classifyAudio` | Classify a single audio file or URL (MP3, WAV, FLAC, OGG, M4A). Supports files up to 25 MB with automatic chunking for larger files. | API Key |
+| `classifyBatch` | Batch classify up to 50 audio files or URLs. | API Key |
+| `listClasses` | List 521+ supported audio classes across 3 taxonomies (AudioSet/YAMNet, AudioSet/PANNs, Species). | None |
+| `healthCheck` | API liveness check. | None |
+
+## Resources
+
+| URI | Description |
+|-----|-------------|
+| `h-ear://status` | Live API status with health, version, available taxonomies, and class counts. |
+
+## Prompts
+
+| Name | Description |
+|------|-------------|
+| `classify-audio` | Pre-built classification workflow prompt with configurable detail level. |
+
+## Options
+
+```
+--key <key>        API key (or set HEAR_API_KEY env var)
+--env <env>        Environment: dev, staging, prod (default: prod)
+--base-url <url>   Override API base URL
+--help, -h         Show help
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `HEAR_API_KEY` | H-ear Enterprise API key | (required for classify tools) |
+| `HEAR_ENV` | Target environment | `prod` |
+| `HEAR_BASE_URL` | Override base URL | Environment default |
+
+## Large File Support
+
+Files larger than 25 MB are automatically split into 120-second chunks with 30-second overlap using ffmpeg. Results are merged and deduplicated. Requires `ffmpeg` and `ffprobe` on PATH.
+
+## Supported Formats
+
+MP3, WAV, FLAC, OGG, M4A
+
+## Requirements
+
+- Node.js >= 18
+- ffmpeg (optional, for large file chunking)
+
+## Get an API Key
+
+Visit [h-ear.world](https://h-ear.world) to create an account and generate an API key.
+
+## License
+
+MIT

package/dist/api-client.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-export API client from @h-ear/core for backwards compatibility.
+ */
+export { HearApiClient, HearApiError } from '@h-ear/core';
+export type { ProgressCallback } from '@h-ear/core';
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/api-client.js

@@ -0,0 +1,5 @@
+/**
+ * Re-export API client from @h-ear/core for backwards compatibility.
+ */
+export { HearApiClient, HearApiError } from '@h-ear/core';
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/chunker.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Re-export chunker from @h-ear/core for backwards compatibility.
+ */
+export { hasFFmpeg, getAudioDuration, splitAudioFile, cleanupChunks, mergeChunkResults, CHUNK_DURATION_SEC, CHUNK_OVERLAP_SEC, } from '@h-ear/core';
+export type { ChunkInfo } from '@h-ear/core';
+export declare const MCP_CHUNK_DURATION_SEC = 120;
+export declare const MCP_CHUNK_OVERLAP_SEC = 30;
+//# sourceMappingURL=chunker.d.ts.map

package/dist/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../src/chunker.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACH,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAC3C,aAAa,EAAE,iBAAiB,EAChC,kBAAkB,EAAE,iBAAiB,GACxC,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,eAAO,MAAM,sBAAsB,MAAqB,CAAC;AACzD,eAAO,MAAM,qBAAqB,KAAoB,CAAC"}

package/dist/chunker.js

@@ -0,0 +1,9 @@
+/**
+ * Re-export chunker from @h-ear/core for backwards compatibility.
+ */
+export { hasFFmpeg, getAudioDuration, splitAudioFile, cleanupChunks, mergeChunkResults, CHUNK_DURATION_SEC, CHUNK_OVERLAP_SEC, } from '@h-ear/core';
+// Backwards-compatible aliases
+import { CHUNK_DURATION_SEC, CHUNK_OVERLAP_SEC } from '@h-ear/core';
+export const MCP_CHUNK_DURATION_SEC = CHUNK_DURATION_SEC;
+export const MCP_CHUNK_OVERLAP_SEC = CHUNK_OVERLAP_SEC;
+//# sourceMappingURL=chunker.js.map

package/dist/chunker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.js","sourceRoot":"","sources":["../src/chunker.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACH,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAC3C,aAAa,EAAE,iBAAiB,EAChC,kBAAkB,EAAE,iBAAiB,GACxC,MAAM,aAAa,CAAC;AAGrB,+BAA+B;AAC/B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACpE,MAAM,CAAC,MAAM,sBAAsB,GAAG,kBAAkB,CAAC;AACzD,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Config resolution for the H-ear MCP server.
+ * Priority: CLI args > env vars > defaults.
+ */
+import { type ServerConfig } from '@h-ear/core';
+export type { ServerConfig };
+export { apiUrl } from '@h-ear/core';
+export declare function resolveConfig(): ServerConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAgB,KAAK,YAAY,EAAwB,MAAM,aAAa,CAAC;AAEpF,YAAY,EAAE,YAAY,EAAE,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAQrC,wBAAgB,aAAa,IAAI,YAAY,CAmB5C"}

package/dist/config.js

@@ -0,0 +1,26 @@
+/**
+ * Config resolution for the H-ear MCP server.
+ * Priority: CLI args > env vars > defaults.
+ */
+import { ENVIRONMENTS } from '@h-ear/core';
+export { apiUrl } from '@h-ear/core';
+function getCliArg(name) {
+    const args = process.argv.slice(2);
+    const idx = args.indexOf(`--${name}`);
+    return idx >= 0 && args[idx + 1] ? args[idx + 1] : undefined;
+}
+export function resolveConfig() {
+    const apiKey = getCliArg('key') || process.env.HEAR_API_KEY || '';
+    const envStr = getCliArg('env') || process.env.HEAR_ENV || 'prod';
+    const environment = (Object.keys(ENVIRONMENTS).includes(envStr) ? envStr : 'prod');
+    const envConfig = ENVIRONMENTS[environment];
+    const baseUrl = getCliArg('base-url') || process.env.HEAR_BASE_URL || envConfig.baseUrl;
+    const apiPath = envConfig.apiPath;
+    if (!apiKey) {
+        process.stderr.write('[h-ear-mcp] Warning: No API key provided. Tools requiring auth (classifyAudio, classifyBatch) will fail.\n' +
+            '  Set HEAR_API_KEY env var or pass --key <key>\n');
+    }
+    process.stderr.write(`[h-ear-mcp] env=${environment} base=${baseUrl}${apiPath}\n`);
+    return { apiKey, environment, baseUrl, apiPath };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAA2C,MAAM,aAAa,CAAC;AAGpF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,SAAS,SAAS,CAAC,IAAY;IAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACtC,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,aAAa;IACzB,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;IAClE,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,MAAM,CAAC;IAElE,MAAM,WAAW,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAoB,CAAC;IACtG,MAAM,SAAS,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,SAAS,CAAC,OAAO,CAAC;IACxF,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;IAElC,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAChB,4GAA4G;YAC5G,kDAAkD,CACrD,CAAC;IACN,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,WAAW,SAAS,OAAO,GAAG,OAAO,IAAI,CAAC,CAAC;IAEnF,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACrD,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-export constants from @h-ear/core for backwards compatibility.
+ */
+export { HEAR_API, ENVIRONMENTS } from '@h-ear/core';
+export type { HearEnvironment } from '@h-ear/core';
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/constants.js

@@ -0,0 +1,5 @@
+/**
+ * Re-export constants from @h-ear/core for backwards compatibility.
+ */
+export { HEAR_API, ENVIRONMENTS } from '@h-ear/core';
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * H-ear MCP Server — Audio classification for AI agents.
+ *
+ * Usage:
+ *   npx @h-ear/mcp-server --key ncm_sk_...
+ *   HEAR_API_KEY=ncm_sk_... npx @h-ear/mcp-server
+ *   npx @h-ear/mcp-server --key ncm_sk_... --env dev
+ *
+ * @see https://h-ear.world
+ */
+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":";AACA;;;;;;;;;GASG"}

package/dist/index.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+/**
+ * H-ear MCP Server — Audio classification for AI agents.
+ *
+ * Usage:
+ *   npx @h-ear/mcp-server --key ncm_sk_...
+ *   HEAR_API_KEY=ncm_sk_... npx @h-ear/mcp-server
+ *   npx @h-ear/mcp-server --key ncm_sk_... --env dev
+ *
+ * @see https://h-ear.world
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { resolveConfig } from './config.js';
+import { createServer } from './server.js';
+async function main() {
+    // Help flag
+    if (process.argv.includes('--help') || process.argv.includes('-h')) {
+        process.stderr.write(`
+  H-ear MCP Server — Audio classification for AI agents
+
+  Usage:
+    npx @h-ear/mcp-server [options]
+
+  Options:
+    --key <key>        API key (or set HEAR_API_KEY env var)
+    --env <env>        Environment: dev, staging, prod (default: prod)
+    --base-url <url>   Override API base URL
+    --help, -h         Show this help
+
+  Tools:
+    classifyAudio      Classify audio (base64 or URL, sync or async)
+    classifyBatch      Batch classify up to 50 audio URLs
+    listClasses        List 521+ supported audio classes
+    healthCheck        API liveness check
+
+  Resources:
+    h-ear://status     Live API status with health, version, taxonomies
+
+  Prompts:
+    classify-audio     Pre-built classification workflow prompt
+
+  Claude Desktop config (claude_desktop_config.json):
+    {
+      "mcpServers": {
+        "h-ear": {
+          "command": "npx",
+          "args": ["-y", "@h-ear/mcp-server"],
+          "env": { "HEAR_API_KEY": "ncm_sk_your_key" }
+        }
+      }
+    }
+\n`);
+        process.exit(0);
+    }
+    const config = resolveConfig();
+    const { server } = createServer(config);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write('[h-ear-mcp] Server started on stdio\n');
+}
+main().catch((error) => {
+    process.stderr.write(`[h-ear-mcp] Fatal: ${error instanceof Error ? error.message : String(error)}\n`);
+    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":";AACA;;;;;;;;;GASG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACf,YAAY;IACZ,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkC1B,CAAC,CAAC;QACG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAExC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;AAClE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/prompts/classify-audio.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerClassifyAudioPrompt(server: McpServer): void;
+//# sourceMappingURL=classify-audio.d.ts.map

package/dist/prompts/classify-audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-audio.d.ts","sourceRoot":"","sources":["../../src/prompts/classify-audio.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgCnE"}

package/dist/prompts/classify-audio.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+export function registerClassifyAudioPrompt(server) {
+    server.prompt('classify-audio', 'Pre-built prompt for audio classification. Guides the AI through classifying audio and interpreting results.', {
+        audioSource: z.string().describe('URL or description of the audio to classify.'),
+        detail: z.enum(['summary', 'detailed', 'timestamps']).default('summary')
+            .describe('Level of detail: summary (top classes), detailed (all classes with low threshold), timestamps (per-second breakdown).'),
+    }, ({ audioSource, detail }) => {
+        const thresholdHint = detail === 'detailed' ? 'threshold: 0.1' : 'threshold: 0.3';
+        const timestampHint = detail === 'timestamps' ? ' Include timestamps in your analysis.' : '';
+        return {
+            messages: [{
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: [
+                            `Classify the following audio: ${audioSource}`,
+                            '',
+                            `Use the classifyAudio tool with ${thresholdHint}.${timestampHint}`,
+                            'After getting results, provide a clear summary of:',
+                            '1. The dominant sounds detected and their confidence levels',
+                            '2. The sound environment category (urban, natural, industrial, etc.)',
+                            '3. Any notable or unusual sounds',
+                        ].join('\n'),
+                    },
+                }],
+        };
+    });
+}
+//# sourceMappingURL=classify-audio.js.map

package/dist/prompts/classify-audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-audio.js","sourceRoot":"","sources":["../../src/prompts/classify-audio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IACzD,MAAM,CAAC,MAAM,CACT,gBAAgB,EAChB,8GAA8G,EAC9G;QACI,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QAChF,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;aACnE,QAAQ,CAAC,uHAAuH,CAAC;KACzI,EACD,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE;QACxB,MAAM,aAAa,GAAG,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAC;QAClF,MAAM,aAAa,GAAG,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,uCAAuC,CAAC,CAAC,CAAC,EAAE,CAAC;QAE7F,OAAO;YACH,QAAQ,EAAE,CAAC;oBACP,IAAI,EAAE,MAAe;oBACrB,OAAO,EAAE;wBACL,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE;4BACF,iCAAiC,WAAW,EAAE;4BAC9C,EAAE;4BACF,mCAAmC,aAAa,IAAI,aAAa,EAAE;4BACnE,oDAAoD;4BACpD,6DAA6D;4BAC7D,sEAAsE;4BACtE,kCAAkC;yBACrC,CAAC,IAAI,CAAC,IAAI,CAAC;qBACf;iBACJ,CAAC;SACL,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/resources/api-status.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { HearApiClient, ServerConfig } from '@h-ear/core';
+export declare function registerApiStatus(server: McpServer, client: HearApiClient, config: ServerConfig): void;
+//# sourceMappingURL=api-status.d.ts.map

package/dist/resources/api-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-status.d.ts","sourceRoot":"","sources":["../../src/resources/api-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA6CtG"}

package/dist/resources/api-status.js

@@ -0,0 +1,41 @@
+export function registerApiStatus(server, client, config) {
+    server.resource('api-status', 'h-ear://status', { description: 'Live H-ear API status including health, version, environment, and available taxonomies', mimeType: 'application/json' }, async (uri) => {
+        try {
+            const [health, classes] = await Promise.all([
+                client.health(),
+                client.listClasses({ limit: 0 }),
+            ]);
+            const status = {
+                ...health,
+                environment: config.environment,
+                baseUrl: config.baseUrl,
+                taxonomies: classes.availableTaxonomies,
+                totalClasses: classes.totalAvailable,
+                categories: classes.categories,
+                timestamp: new Date().toISOString(),
+            };
+            return {
+                contents: [{
+                        uri: uri.href,
+                        mimeType: 'application/json',
+                        text: JSON.stringify(status, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                contents: [{
+                        uri: uri.href,
+                        mimeType: 'application/json',
+                        text: JSON.stringify({
+                            status: 'error',
+                            error: error instanceof Error ? error.message : String(error),
+                            environment: config.environment,
+                            timestamp: new Date().toISOString(),
+                        }, null, 2),
+                    }],
+            };
+        }
+    });
+}
+//# sourceMappingURL=api-status.js.map

package/dist/resources/api-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-status.js","sourceRoot":"","sources":["../../src/resources/api-status.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,MAAqB,EAAE,MAAoB;IAC5F,MAAM,CAAC,QAAQ,CACX,YAAY,EACZ,gBAAgB,EAChB,EAAE,WAAW,EAAE,wFAAwF,EAAE,QAAQ,EAAE,kBAAkB,EAAE,EACvI,KAAK,EAAE,GAAG,EAAE,EAAE;QACV,IAAI,CAAC;YACD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACxC,MAAM,CAAC,MAAM,EAAE;gBACf,MAAM,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;aACnC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG;gBACX,GAAG,MAAM;gBACT,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,UAAU,EAAE,OAAO,CAAC,mBAAmB;gBACvC,YAAY,EAAE,OAAO,CAAC,cAAc;gBACpC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC;YAEF,OAAO;gBACH,QAAQ,EAAE,CAAC;wBACP,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACxC,CAAC;aACL,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO;gBACH,QAAQ,EAAE,CAAC;wBACP,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACjB,MAAM,EAAE,OAAO;4BACf,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;4BAC7D,WAAW,EAAE,MAAM,CAAC,WAAW;4BAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;yBACtC,EAAE,IAAI,EAAE,CAAC,CAAC;qBACd,CAAC;aACL,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,11 @@
+/**
+ * H-ear MCP Server — registers all tools, resources, and prompts.
+ * Exported for testing (InMemoryTransport) and programmatic use.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { HearApiClient, type ServerConfig } from '@h-ear/core';
+export declare function createServer(config: ServerConfig): {
+    server: McpServer;
+    client: HearApiClient;
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAW/D,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAwB/F"}

package/dist/server.js

@@ -0,0 +1,33 @@
+/**
+ * H-ear MCP Server — registers all tools, resources, and prompts.
+ * Exported for testing (InMemoryTransport) and programmatic use.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { HearApiClient } from '@h-ear/core';
+import { registerHealthCheck } from './tools/health-check.js';
+import { registerListClasses } from './tools/list-classes.js';
+import { registerClassifyAudio } from './tools/classify-audio.js';
+import { registerClassifyBatch } from './tools/classify-batch.js';
+import { registerUsage } from './tools/usage.js';
+import { registerListJobs } from './tools/list-jobs.js';
+import { registerGetJob } from './tools/get-job.js';
+import { registerApiStatus } from './resources/api-status.js';
+import { registerClassifyAudioPrompt } from './prompts/classify-audio.js';
+export function createServer(config) {
+    const server = new McpServer({ name: 'h-ear-mcp', version: '0.1.0' }, { capabilities: { logging: {} } });
+    const client = new HearApiClient(config);
+    // Tools
+    registerHealthCheck(server, client);
+    registerListClasses(server, client);
+    registerClassifyAudio(server, client);
+    registerClassifyBatch(server, client);
+    registerUsage(server, client);
+    registerListJobs(server, client);
+    registerGetJob(server, client);
+    // Resources
+    registerApiStatus(server, client, config);
+    // Prompts
+    registerClassifyAudioPrompt(server);
+    return { server, client };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAqB,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAE1E,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC7C,MAAM,MAAM,GAAG,IAAI,SAAS,CACxB,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,EACvC,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CACpC,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAEzC,QAAQ;IACR,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE/B,YAAY;IACZ,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAE1C,UAAU;IACV,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAEpC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC"}

package/dist/tools/classify-audio.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type HearApiClient } from '@h-ear/core';
+export declare function registerClassifyAudio(server: McpServer, client: HearApiClient): void;
+//# sourceMappingURL=classify-audio.d.ts.map

package/dist/tools/classify-audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-audio.d.ts","sourceRoot":"","sources":["../../src/tools/classify-audio.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EACH,KAAK,aAAa,EAErB,MAAM,aAAa,CAAC;AAKrB,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CA0GpF"}

package/dist/tools/classify-audio.js

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+import { readFileSync, existsSync, statSync } from 'fs';
+import { basename, extname } from 'path';
+import { HEAR_API, hasFFmpeg, getAudioDuration, splitAudioFile, cleanupChunks, mergeChunkResults, } from '@h-ear/core';
+const formats = HEAR_API.SUPPORTED_FORMATS.join(', ');
+const maxMB = HEAR_API.MAX_FILE_SIZE_BYTES / (1024 * 1024);
+export function registerClassifyAudio(server, client) {
+    server.tool('classifyAudio', `Classify a local audio file or public URL for noise/sound detection. Provide filePath (recommended) or url. Returns detected sound classes with confidence scores. Formats: ${formats}. Files over ${maxMB}MB are automatically split into overlapping chunks using ffmpeg. Requires API key (HEAR_API_KEY). Runs async — submits job and polls for results.`, {
+        filePath: z.string().optional()
+            .describe('Path to a local audio file. The server reads and encodes it automatically. Large files are split into chunks. Recommended.'),
+        url: z.string().url().optional()
+            .describe('Public URL to audio file.'),
+        threshold: z.number().min(0).max(1).default(0.3)
+            .describe('Confidence threshold (0.0-1.0). Only classes above this score are returned.'),
+        filterMinDurationSeconds: z.number().min(0.1).max(595).optional()
+            .describe('Minimum event duration filter in seconds.'),
+    }, async (params) => {
+        try {
+            const onProgress = (msg) => process.stderr.write(`[h-ear-mcp] ${msg}\n`);
+            // URL mode: pass through directly
+            if (params.url) {
+                const result = await client.classify({ url: params.url, threshold: params.threshold, filterMinDurationSeconds: params.filterMinDurationSeconds }, onProgress);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            if (!params.filePath) {
+                return { content: [{ type: 'text', text: 'Error: Provide filePath or url.' }], isError: true };
+            }
+            // Validate file exists and format
+            if (!existsSync(params.filePath)) {
+                return { content: [{ type: 'text', text: `Error: File not found: ${params.filePath}` }], isError: true };
+            }
+            const ext = extname(params.filePath).toLowerCase().replace('.', '').toUpperCase();
+            if (!HEAR_API.SUPPORTED_FORMATS.includes(ext)) {
+                return { content: [{ type: 'text', text: `Error: Unsupported format: ${ext}. Supported: ${formats}` }], isError: true };
+            }
+            const stat = statSync(params.filePath);
+            const fileSizeMB = stat.size / (1024 * 1024);
+            // Small file: read, encode, submit directly
+            if (stat.size <= HEAR_API.MAX_FILE_SIZE_BYTES) {
+                onProgress(`Reading ${basename(params.filePath)} (${fileSizeMB.toFixed(1)}MB)`);
+                const result = await client.classify({
+                    base64: readFileSync(params.filePath).toString('base64'),
+                    fileName: basename(params.filePath),
+                    threshold: params.threshold,
+                    filterMinDurationSeconds: params.filterMinDurationSeconds,
+                }, onProgress);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            // Large file: split into overlapping chunks with ffmpeg
+            if (!hasFFmpeg()) {
+                return { content: [{ type: 'text', text: `Error: File is ${fileSizeMB.toFixed(1)}MB (over ${maxMB}MB limit). ffmpeg is required to split large files but was not found in PATH. Install ffmpeg and retry.` }], isError: true };
+            }
+            onProgress(`Large file (${fileSizeMB.toFixed(1)}MB) — splitting into chunks with 30s overlap`);
+            const totalDuration = getAudioDuration(params.filePath);
+            if (totalDuration <= 0) {
+                return { content: [{ type: 'text', text: 'Error: Could not determine audio duration. Is the file valid?' }], isError: true };
+            }
+            onProgress(`Duration: ${totalDuration.toFixed(1)}s — splitting into overlapping chunks`);
+            const chunks = splitAudioFile(params.filePath, totalDuration);
+            if (chunks.length === 0) {
+                return { content: [{ type: 'text', text: 'Error: ffmpeg failed to split file into chunks.' }], isError: true };
+            }
+            onProgress(`Split into ${chunks.length} chunks — submitting all async`);
+            // Submit all chunks async (fast — each returns 202)
+            const submitted = [];
+            for (const chunk of chunks) {
+                const base64 = readFileSync(chunk.path).toString('base64');
+                const accepted = await client.submitClassify({
+                    base64,
+                    fileName: `${basename(params.filePath)}_chunk${chunk.index}.mp3`,
+                    threshold: params.threshold,
+                    filterMinDurationSeconds: params.filterMinDurationSeconds,
+                });
+                submitted.push({ chunk, requestId: accepted.requestId });
+                onProgress(`Chunk ${chunk.index} submitted: ${accepted.requestId} (${chunk.startTime}s-${chunk.startTime + chunk.duration}s)`);
+            }
+            // Poll all chunks for results
+            const chunkResults = [];
+            for (const { chunk, requestId } of submitted) {
+                onProgress(`Polling chunk ${chunk.index} (${requestId})...`);
+                const result = await client.pollJob(requestId, onProgress);
+                chunkResults.push({ chunk, result });
+            }
+            // Cleanup temp files
+            cleanupChunks(chunks);
+            // Merge results with timestamp offsets and deduplication
+            const merged = mergeChunkResults(chunkResults, basename(params.filePath), totalDuration);
+            onProgress(`Merged: ${merged.eventCount} events from ${chunks.length} chunks`);
+            return { content: [{ type: 'text', text: JSON.stringify(merged, null, 2) }] };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return { content: [{ type: 'text', text: `Classification failed: ${msg}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=classify-audio.js.map

package/dist/tools/classify-audio.js.map

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

package/dist/tools/classify-batch.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type HearApiClient } from '@h-ear/core';
+export declare function registerClassifyBatch(server: McpServer, client: HearApiClient): void;
+//# sourceMappingURL=classify-batch.d.ts.map

package/dist/tools/classify-batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-batch.d.ts","sourceRoot":"","sources":["../../src/tools/classify-batch.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,KAAK,aAAa,EAAY,MAAM,aAAa,CAAC;AAK3D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAsHpF"}

package/dist/tools/classify-batch.js

@@ -0,0 +1,116 @@
+import { z } from 'zod';
+import { readFileSync, existsSync, statSync } from 'fs';
+import { basename, extname } from 'path';
+import { HEAR_API } from '@h-ear/core';
+const formats = HEAR_API.SUPPORTED_FORMATS.join(', ');
+const maxMB = HEAR_API.MAX_FILE_SIZE_BYTES / (1024 * 1024);
+export function registerClassifyBatch(server, client) {
+    server.tool('classifyBatch', `Classify multiple audio files. Provide filePaths for local files (recommended) or files with URLs. Local files: submits all async, then polls for results. URL files: uses batch endpoint with webhook. Max ${HEAR_API.MAX_BATCH_FILES} files. Requires API key (HEAR_API_KEY).`, {
+        filePaths: z.array(z.string()).min(1).max(HEAR_API.MAX_BATCH_FILES).optional()
+            .describe('Array of local audio file paths to classify. Recommended.'),
+        files: z.array(z.object({
+            url: z.string().url().describe('Public URL to audio file.'),
+            id: z.string().optional().describe('Client-provided tracking ID.'),
+        })).min(1).max(HEAR_API.MAX_BATCH_FILES).optional()
+            .describe('Array of public audio URLs (alternative to filePaths). Requires callbackUrl.'),
+        callbackUrl: z.string().url().optional()
+            .describe('Webhook URL (HTTPS) for async results. Required when using URL-based files.'),
+        callbackSecret: z.string().optional()
+            .describe('HMAC-SHA256 secret for webhook signature verification.'),
+        threshold: z.number().min(0).max(1).default(0.3)
+            .describe('Confidence threshold for all files.'),
+        filterMinDurationSeconds: z.number().min(0.1).max(595).optional()
+            .describe('Minimum event duration filter in seconds.'),
+    }, async (params) => {
+        try {
+            // Local file mode: submit all async, then poll all
+            if (params.filePaths) {
+                const jobs = [];
+                // Phase 1: Submit all files (fast — each returns 202 immediately)
+                for (const filePath of params.filePaths) {
+                    if (!existsSync(filePath)) {
+                        jobs.push({ file: filePath, error: 'File not found' });
+                        continue;
+                    }
+                    const stat = statSync(filePath);
+                    if (stat.size > HEAR_API.MAX_FILE_SIZE_BYTES) {
+                        jobs.push({ file: filePath, error: `File too large: ${(stat.size / 1024 / 1024).toFixed(1)}MB` });
+                        continue;
+                    }
+                    const ext = extname(filePath).toLowerCase().replace('.', '').toUpperCase();
+                    if (!HEAR_API.SUPPORTED_FORMATS.includes(ext)) {
+                        jobs.push({ file: filePath, error: `Unsupported format: ${ext}` });
+                        continue;
+                    }
+                    try {
+                        const base64 = readFileSync(filePath).toString('base64');
+                        const accepted = await client.submitClassify({
+                            base64,
+                            fileName: basename(filePath),
+                            threshold: params.threshold,
+                            filterMinDurationSeconds: params.filterMinDurationSeconds,
+                        });
+                        jobs.push({ file: basename(filePath), requestId: accepted.requestId });
+                        process.stderr.write(`[h-ear-mcp] Submitted ${basename(filePath)} → ${accepted.requestId}\n`);
+                    }
+                    catch (err) {
+                        jobs.push({ file: basename(filePath), error: err instanceof Error ? err.message : String(err) });
+                    }
+                }
+                // Phase 2: Poll all submitted jobs for results
+                const results = [];
+                for (const job of jobs) {
+                    if (job.error) {
+                        results.push({ file: job.file, status: 'error', error: job.error });
+                        continue;
+                    }
+                    try {
+                        const onProgress = (msg) => process.stderr.write(`[h-ear-mcp] ${msg}\n`);
+                        const result = await client.pollJob(job.requestId, onProgress);
+                        results.push({ file: job.file, status: 'classified', result });
+                    }
+                    catch (err) {
+                        results.push({ file: job.file, status: 'error', error: err instanceof Error ? err.message : String(err) });
+                    }
+                }
+                const summary = {
+                    mode: 'local-async',
+                    totalFiles: params.filePaths.length,
+                    classified: results.filter(r => r.status === 'classified').length,
+                    failed: results.filter(r => r.status === 'error').length,
+                    results,
+                };
+                return { content: [{ type: 'text', text: JSON.stringify(summary, null, 2) }] };
+            }
+            // URL mode: use batch endpoint
+            if (params.files) {
+                if (!params.callbackUrl) {
+                    return {
+                        content: [{ type: 'text', text: 'Error: callbackUrl is required when using URL-based files.' }],
+                        isError: true,
+                    };
+                }
+                const result = await client.classifyBatch({
+                    files: params.files,
+                    callbackUrl: params.callbackUrl,
+                    callbackSecret: params.callbackSecret,
+                    threshold: params.threshold,
+                    filterMinDurationSeconds: params.filterMinDurationSeconds,
+                });
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            return {
+                content: [{ type: 'text', text: 'Error: Provide filePaths (local files) or files (URLs).' }],
+                isError: true,
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: 'text', text: `Batch classification failed: ${msg}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=classify-batch.js.map

package/dist/tools/classify-batch.js.map

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

package/dist/tools/get-job.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { HearApiClient } from '@h-ear/core';
+export declare function registerGetJob(server: McpServer, client: HearApiClient): void;
+//# sourceMappingURL=get-job.d.ts.map

package/dist/tools/get-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-job.d.ts","sourceRoot":"","sources":["../../src/tools/get-job.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAoB7E"}

package/dist/tools/get-job.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export function registerGetJob(server, client) {
+    server.tool('getJob', 'Get detailed results for a specific classification job, including all detected sound events and classifications. Requires API key (HEAR_API_KEY).', {
+        jobId: z.string().min(1)
+            .describe('The job ID returned from classifyAudio or classifyBatch.'),
+    }, async (params) => {
+        try {
+            const result = await client.getJob(params.jobId);
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Get job failed: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-job.js.map

package/dist/tools/get-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-job.js","sourceRoot":"","sources":["../../src/tools/get-job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,cAAc,CAAC,MAAiB,EAAE,MAAqB;IACnE,MAAM,CAAC,IAAI,CACP,QAAQ,EACR,mJAAmJ,EACnJ;QACI,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;aACnB,QAAQ,CAAC,0DAA0D,CAAC;KAC5E,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACb,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,mBAAmB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBACvH,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/health-check.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { HearApiClient } from '@h-ear/core';
+export declare function registerHealthCheck(server: McpServer, client: HearApiClient): void;
+//# sourceMappingURL=health-check.d.ts.map

package/dist/tools/health-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.d.ts","sourceRoot":"","sources":["../../src/tools/health-check.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAiBlF"}

package/dist/tools/health-check.js

@@ -0,0 +1,15 @@
+export function registerHealthCheck(server, client) {
+    server.tool('healthCheck', 'Check H-ear API health and liveness. No authentication required. Returns status, version, and deployment timestamp.', {}, async () => {
+        try {
+            const result = await client.health();
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Health check failed: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=health-check.js.map

package/dist/tools/health-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.js","sourceRoot":"","sources":["../../src/tools/health-check.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAqB;IACxE,MAAM,CAAC,IAAI,CACP,aAAa,EACb,qHAAqH,EACrH,EAAE,EACF,KAAK,IAAI,EAAE;QACP,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;YACrC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,wBAAwB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBAC5H,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/list-classes.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { HearApiClient } from '@h-ear/core';
+export declare function registerListClasses(server: McpServer, client: HearApiClient): void;
+//# sourceMappingURL=list-classes.d.ts.map

package/dist/tools/list-classes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-classes.d.ts","sourceRoot":"","sources":["../../src/tools/list-classes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CA0BlF"}

package/dist/tools/list-classes.js

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+export function registerListClasses(server, client) {
+    server.tool('listClasses', 'List supported audio classification classes. Default taxonomy: audioset-yamnet-521 (521 classes across 7 categories). Also available: audioset-panns-527 (527 classes), species (6522 bird species). No authentication required.', {
+        taxonomy: z.enum(['audioset-yamnet-521', 'audioset-panns-527', 'species']).optional()
+            .describe('Taxonomy to query. Defaults to audioset-yamnet-521.'),
+        category: z.string().optional()
+            .describe('Filter by category name (case-insensitive partial match). E.g. "Animal", "Human sounds", "Music".'),
+        limit: z.number().int().positive().optional()
+            .describe('Max classes to return (pagination).'),
+        offset: z.number().int().min(0).optional()
+            .describe('Number of classes to skip (pagination).'),
+    }, async (params) => {
+        try {
+            const result = await client.listClasses(params);
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `List classes failed: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=list-classes.js.map

package/dist/tools/list-classes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-classes.js","sourceRoot":"","sources":["../../src/tools/list-classes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAqB;IACxE,MAAM,CAAC,IAAI,CACP,aAAa,EACb,kOAAkO,EAClO;QACI,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,qBAAqB,EAAE,oBAAoB,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;aAChF,QAAQ,CAAC,qDAAqD,CAAC;QACpE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aAC1B,QAAQ,CAAC,mGAAmG,CAAC;QAClH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;aACxC,QAAQ,CAAC,qCAAqC,CAAC;QACpD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;aACrC,QAAQ,CAAC,yCAAyC,CAAC;KAC3D,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACb,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAChD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,wBAAwB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBAC5H,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/list-jobs.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { HearApiClient } from '@h-ear/core';
+export declare function registerListJobs(server: McpServer, client: HearApiClient): void;
+//# sourceMappingURL=list-jobs.d.ts.map

package/dist/tools/list-jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-jobs.d.ts","sourceRoot":"","sources":["../../src/tools/list-jobs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAwB/E"}

package/dist/tools/list-jobs.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+export function registerListJobs(server, client) {
+    server.tool('listJobs', 'List recent classification jobs with status, file name, event count, and timestamps. Supports pagination. Requires API key (HEAR_API_KEY).', {
+        limit: z.number().int().positive().max(100).default(10)
+            .describe('Max jobs to return (1-100, default 10).'),
+        offset: z.number().int().min(0).default(0)
+            .describe('Number of jobs to skip (pagination).'),
+        status: z.enum(['processing', 'completed', 'failed']).optional()
+            .describe('Filter by job status.'),
+    }, async (params) => {
+        try {
+            const result = await client.listJobs(params);
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `List jobs failed: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=list-jobs.js.map

package/dist/tools/list-jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-jobs.js","sourceRoot":"","sources":["../../src/tools/list-jobs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,MAAqB;IACrE,MAAM,CAAC,IAAI,CACP,UAAU,EACV,4IAA4I,EAC5I;QACI,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;aAClD,QAAQ,CAAC,yCAAyC,CAAC;QACxD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;aACrC,QAAQ,CAAC,sCAAsC,CAAC;QACrD,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;aAC3D,QAAQ,CAAC,uBAAuB,CAAC;KACzC,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACb,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC7C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,qBAAqB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBACzH,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/usage.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { HearApiClient } from '@h-ear/core';
+export declare function registerUsage(server: McpServer, client: HearApiClient): void;
+//# sourceMappingURL=usage.d.ts.map

package/dist/tools/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/tools/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAiB5E"}

package/dist/tools/usage.js

@@ -0,0 +1,15 @@
+export function registerUsage(server, client) {
+    server.tool('usage', 'Get H-ear API usage statistics: minutes used, calls today, quota remaining, active keys. Requires API key (HEAR_API_KEY).', {}, async () => {
+        try {
+            const result = await client.usage();
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Usage check failed: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=usage.js.map

package/dist/tools/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/tools/usage.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,MAAqB;IAClE,MAAM,CAAC,IAAI,CACP,OAAO,EACP,2HAA2H,EAC3H,EAAE,EACF,KAAK,IAAI,EAAE;QACP,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACpC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,uBAAuB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBAC3H,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Re-export all types from @h-ear/core for backwards compatibility.
+ */
+export type { ClassifyRequest, ClassifyResult, Classification, NoiseEvent, AsyncAccepted, BatchFile, BatchRequest, BatchAccepted, AudioClass, ClassesResult, HealthResult, UsageResult, JobSummary, JobsResult, JobResult, WebhookRegister, WebhookResult, ApiErrorBody, } from '@h-ear/core';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,YAAY,EACR,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAC1E,SAAS,EAAE,YAAY,EAAE,aAAa,EACtC,UAAU,EAAE,aAAa,EACzB,YAAY,EACZ,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAC9C,eAAe,EAAE,aAAa,EAC9B,YAAY,GACf,MAAM,aAAa,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@h-ear/mcp-server",
+  "version": "0.1.0-dev.202603280915",
+  "description": "MCP server for the H-ear World audio classification API — connect Claude, ChatGPT, and other AI agents to 521+ sound classes",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "h-ear-mcp": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./server": {
+      "import": "./dist/server.js",
+      "types": "./dist/server.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:unit": "vitest run --config vitest.config.ts",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "prepublishOnly": "npm run build",
+    "version:patch": "npm version patch --no-git-tag-version",
+    "version:minor": "npm version minor --no-git-tag-version",
+    "version:major": "npm version major --no-git-tag-version"
+  },
+  "dependencies": {
+    "@h-ear/core": "*",
+    "@modelcontextprotocol/sdk": "^1.26.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "audio",
+    "classification",
+    "h-ear",
+    "noise",
+    "sound",
+    "ai-agent"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/noise-control-monitor/ncm-monorepo",
+    "directory": "packages/mcp-server"
+  }
+}