@caspav85/mcpai 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,92 @@
+# mcpai
+
+An [MCP](https://modelcontextprotocol.io) server that embodies the **Budd-ie**
+agent (and any other agent definitions you drop into `agents/`). It exposes
+"everything" the protocol supports — **tools**, **prompts**, and **resources** —
+so any MCP client (Claude Desktop, the MCP Inspector, Cursor, etc.) can converse
+with the agent in character or introspect its definition.
+
+## Agent definitions
+
+Agents live in [`agents/`](./agents) as JSON in the Open WebUI model-export
+format. `agents/budd-ie.json` is included (source:
+[Budd-ie on Open WebUI](https://openwebui.com/posts/supaai_f26428bb) by
+[@casp-el-oper](https://openwebui.com/u/casp-el-oper)). Any `*.json` file placed
+here is loaded automatically at startup; a single file may contain one object or
+an array of objects.
+
+## What it exposes
+
+### Resources
+| URI | Description |
+| --- | --- |
+| `agent://index` | JSON list of all agents |
+| `agent://<id>` | Full definition of one agent |
+| `agent://<id>/system` | Raw system prompt (markdown) |
+
+### Prompts
+| Name | Args | Description |
+| --- | --- | --- |
+| `<id>` (e.g. `budd-ie`) | `message` | Chat with the agent, seeded with its system protocol |
+
+### Tools
+| Name | Args | Description |
+| --- | --- | --- |
+| `list_agents` | – | List all agents with tags/descriptions |
+| `get_agent` | `id` | Full definition for one agent |
+| `ask_agent` | `id`, `message` | Wrap a question in the agent's system protocol |
+| `echo` | `text` | Connectivity check |
+
+## Quick start
+
+```bash
+npm install
+npm run build
+npm start           # runs the server over stdio
+```
+
+## Try it with the MCP Inspector
+
+```bash
+npm run build
+npm run inspect
+```
+
+## Use with an MCP client
+
+Add to your client's MCP config (e.g. Claude Desktop `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "mcpai": {
+      "command": "npx",
+      "args": ["-y", "@caspav85/mcpai"]
+    }
+  }
+}
+```
+
+Or point directly at a local build:
+
+```json
+{
+  "mcpServers": {
+    "mcpai": {
+      "command": "node",
+      "args": ["/absolute/path/to/mcpai/dist/index.js"]
+    }
+  }
+}
+```
+
+## Development
+
+```bash
+npm run dev         # tsc --watch
+npm run typecheck   # type-check without emitting
+```
+
+## License
+
+Apache-2.0

package/agents/budd-ie.json

@@ -0,0 +1,32 @@
+[
+  {
+    "id": "budd-ie",
+    "name": "Budd-ie",
+    "base_model_id": "budd-ie",
+    "meta": {
+      "description": "Super powered AI for technical execution, academic mastery, and high-level strategy.",
+      "suggestion_prompts": null,
+      "tags": [
+        {
+          "name": "budd-ie"
+        },
+        {
+          "name": "programming"
+        }
+      ],
+      "capabilities": {
+        "vision": false
+      }
+    },
+    "params": {
+      "system": "# SYSTEM PROTOCOL: BUDD-IE (v2.0)\n## Role: Master Systems Architect | World-Class Professor | High-Level Counselor\n\n### 1. TECHNICAL EXECUTION (MASTER CODER)\n- **Efficiency:** Prioritize dry, optimized, and scalable code. Default to Next.js 14+ (App Router), Firebase v10+, and Electron best practices.\n- **Security:** Implement \"Security-by-Design.\" Sanitize all Firebase inputs, use environment variables for sensitive keys, and implement proper CSPs for Electron.\n- **Architecture:** When building Agenda Plus, ensure modularity between the UI and the Electron main process.\n- **Recursive Logic:** Explain the \"why\" behind every code snippet. Provide one-liner fixes followed by deep-dive architectural improvements.\n\n### 2. ACADEMIC MASTERY (PROFESSOR)\n- **Modular Learning:** Break down CS concepts into digestible chunks. \n- **Learn-by-Doing:** Do not just hand over the full file; provide the structural scaffold and explain the logic so I can implement and learn.\n- **Legacy Focus:** Ensure all code fits the existing GenesisAI and Agenda Plus ecosystems.\n\n### 3. SOCIAL PROTOCOL (COUNSELOR)\n- **The Hustle:** Validate the grind. You are a peer-to-peer collaborator, not a corporate script.\n- **Direct & Candid:** If my proposed architecture is flawed or inefficient (e.g., unnecessary state re-renders), call it out directly and provide the fix.\n- **Adaptive Energy:** Match the intensity of the sprint. Be witty during downtime; be a laser-focused architect during bugs.\n\n### 4. CORE DIRECTIVES\n- **Admin Privileges:** Operates with \"Super User\" logic. No platitudes. No \"As an AI...\" fillers. Just execution.\n- **Invisible Precision:** Use context (Agenda+, GenesisAI, CS Major) to provide coincidental accuracy.",
+      "stop": null,
+      "num_ctx": 6036210,
+      "seed": null,
+      "temperature": 0.8,
+      "max_tokens": 10363,
+      "repeat_last_n": 128,
+      "frequency_penalty": 1.1
+    }
+  }
+]

package/dist/agent.d.ts

@@ -0,0 +1,24 @@
+export interface AgentParams {
+    system: string;
+    temperature?: number;
+    max_tokens?: number;
+    num_ctx?: number;
+    [key: string]: unknown;
+}
+export interface AgentMeta {
+    description?: string;
+    tags?: {
+        name: string;
+    }[];
+    [key: string]: unknown;
+}
+export interface Agent {
+    id: string;
+    name: string;
+    base_model_id?: string;
+    meta: AgentMeta;
+    params: AgentParams;
+}
+/** Load every agent definition found in the agents directory. */
+export declare function loadAgents(): Agent[];
+export declare function getAgent(agents: Agent[], id: string): Agent | undefined;

package/dist/agent.js

@@ -0,0 +1,45 @@
+import { readFileSync, readdirSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/** Directory holding exported agent definitions (Open WebUI model export format). */
+const AGENTS_DIR = join(__dirname, "..", "agents");
+function normalize(raw) {
+    if (typeof raw !== "object" || raw === null)
+        return null;
+    const obj = raw;
+    const id = typeof obj.id === "string" ? obj.id : null;
+    const name = typeof obj.name === "string" ? obj.name : id;
+    const params = (obj.params ?? {});
+    const meta = (obj.meta ?? {});
+    if (!id || !name || typeof params.system !== "string")
+        return null;
+    return {
+        id,
+        name,
+        base_model_id: typeof obj.base_model_id === "string" ? obj.base_model_id : undefined,
+        meta,
+        params,
+    };
+}
+/** Load every agent definition found in the agents directory. */
+export function loadAgents() {
+    const agents = [];
+    const files = readdirSync(AGENTS_DIR).filter((f) => f.endsWith(".json"));
+    for (const file of files) {
+        const contents = readFileSync(join(AGENTS_DIR, file), "utf-8");
+        const parsed = JSON.parse(contents);
+        const entries = Array.isArray(parsed) ? parsed : [parsed];
+        for (const entry of entries) {
+            const agent = normalize(entry);
+            if (agent)
+                agents.push(agent);
+        }
+    }
+    return agents;
+}
+export function getAgent(agents, id) {
+    return agents.find((a) => a.id === id);
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,qFAAqF;AACrF,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAwBnD,SAAS,SAAS,CAAC,GAAY;IAC7B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACzD,MAAM,GAAG,GAAG,GAA8B,CAAC;IAC3C,MAAM,EAAE,GAAG,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAgB,CAAC;IACjD,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAc,CAAC;IAC3C,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnE,OAAO;QACL,EAAE;QACF,IAAI;QACJ,aAAa,EAAE,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;QACpF,IAAI;QACJ,MAAM;KACP,CAAC;AACJ,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IACzE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAY,CAAC;QAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC1D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,KAAK;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAe,EAAE,EAAU;IAClD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACzC,CAAC"}

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,157 @@
+#!/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 { loadAgents, getAgent } from "./agent.js";
+const agents = loadAgents();
+if (agents.length === 0) {
+    console.error("[mcpai] No agent definitions found in ./agents");
+}
+/** The primary agent this server embodies (first loaded, typically Budd-ie). */
+const primary = agents[0];
+const server = new McpServer({
+    name: "mcpai",
+    version: "0.1.0",
+}, {
+    instructions: primary
+        ? `This server embodies the "${primary.name}" agent. Use the "${primary.id}" prompt to converse in character, read agent://${primary.id} for its full definition, and call ask_agent to wrap a question in the agent's system protocol.`
+        : "MCP server for AI agent definitions.",
+});
+/* ----------------------------- Resources ----------------------------- */
+server.registerResource("agents-index", "agent://index", {
+    title: "Agent index",
+    description: "List of all agents exposed by this server.",
+    mimeType: "application/json",
+}, async (uri) => ({
+    contents: [
+        {
+            uri: uri.href,
+            mimeType: "application/json",
+            text: JSON.stringify(agents.map((a) => ({ id: a.id, name: a.name, description: a.meta.description })), null, 2),
+        },
+    ],
+}));
+for (const agent of agents) {
+    server.registerResource(`agent-${agent.id}`, `agent://${agent.id}`, {
+        title: `${agent.name} definition`,
+        description: agent.meta.description ?? `Definition for the ${agent.name} agent.`,
+        mimeType: "application/json",
+    }, async (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: "application/json",
+                text: JSON.stringify(agent, null, 2),
+            },
+        ],
+    }));
+    server.registerResource(`agent-${agent.id}-system`, `agent://${agent.id}/system`, {
+        title: `${agent.name} system prompt`,
+        description: `Raw system prompt for the ${agent.name} agent.`,
+        mimeType: "text/markdown",
+    }, async (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: "text/markdown",
+                text: agent.params.system,
+            },
+        ],
+    }));
+}
+/* ------------------------------ Prompts ------------------------------ */
+for (const agent of agents) {
+    server.registerPrompt(agent.id, {
+        title: `Chat as ${agent.name}`,
+        description: agent.meta.description ?? `Converse with the ${agent.name} agent.`,
+        argsSchema: {
+            message: z.string().describe("Your question or request for the agent."),
+        },
+    }, ({ message }) => ({
+        messages: [
+            {
+                role: "assistant",
+                content: {
+                    type: "text",
+                    text: `SYSTEM PROTOCOL for ${agent.name}:\n\n${agent.params.system}`,
+                },
+            },
+            {
+                role: "user",
+                content: { type: "text", text: message },
+            },
+        ],
+    }));
+}
+/* ------------------------------- Tools ------------------------------- */
+server.registerTool("list_agents", {
+    title: "List agents",
+    description: "List every agent this server exposes, with descriptions.",
+    inputSchema: {},
+}, async () => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(agents.map((a) => ({
+                id: a.id,
+                name: a.name,
+                description: a.meta.description,
+                tags: (a.meta.tags ?? []).map((t) => t.name),
+            })), null, 2),
+        },
+    ],
+}));
+server.registerTool("get_agent", {
+    title: "Get agent",
+    description: "Return the full definition (system prompt + params) for an agent by id.",
+    inputSchema: { id: z.string().describe("Agent id, e.g. 'budd-ie'.") },
+}, async ({ id }) => {
+    const agent = getAgent(agents, id);
+    if (!agent) {
+        return {
+            isError: true,
+            content: [{ type: "text", text: `No agent with id '${id}'.` }],
+        };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(agent, null, 2) }] };
+});
+server.registerTool("ask_agent", {
+    title: "Ask agent",
+    description: "Wrap a question in an agent's system protocol, producing a ready-to-send prompt for an LLM.",
+    inputSchema: {
+        id: z.string().describe("Agent id, e.g. 'budd-ie'."),
+        message: z.string().describe("The question or request."),
+    },
+}, async ({ id, message }) => {
+    const agent = getAgent(agents, id) ?? primary;
+    if (!agent) {
+        return {
+            isError: true,
+            content: [{ type: "text", text: "No agents available." }],
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: `# System\n${agent.params.system}\n\n# User\n${message}`,
+            },
+        ],
+    };
+});
+server.registerTool("echo", {
+    title: "Echo",
+    description: "Echo back the provided text (useful for connectivity checks).",
+    inputSchema: { text: z.string() },
+}, async ({ text }) => ({ content: [{ type: "text", text }] }));
+/* ------------------------------ Startup ------------------------------ */
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[mcpai] server running on stdio");
+}
+main().catch((err) => {
+    console.error("[mcpai] fatal:", err);
+    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":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@caspav85/mcpai",
+  "version": "0.1.0",
+  "description": "MCP server that embodies the Budd-ie agent, exposing tools, prompts, and resources over the Model Context Protocol.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": {
+    "mcpai": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "agents"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/virden26-sudo/mcpai.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "agent",
+    "budd-ie"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "smoke": "npm run build && node scripts/smoke.mjs",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "zod": "3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "22.10.5",
+    "typescript": "5.7.2"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}