@microsoft/m365agentstoolkit-mcp 0.1.0-alpha.18ed8019e.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2020 Microsoft
+
+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 @@
+# @microsoft/mcp-m365

package/dist/fetcher.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchSchema = exports.clearSchemaCache = exports.SchemaTypeEnum = void 0;
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+const zod_1 = require("zod");
+/**
+ * Schema types supported by the fetcher
+ */
+exports.SchemaTypeEnum = zod_1.z.enum([
+    "app_manifest",
+    "declarative_agent_manifest",
+    "api_plugin_manifest",
+]);
+/**
+ * Repository configurations for each schema type
+ */
+const schemaRepositories = {
+    app_manifest: {
+        baseUrl: `https://developer.microsoft.com/json-schemas/teams/{{version}}/MicrosoftTeams.schema.json`,
+    },
+    declarative_agent_manifest: {
+        baseUrl: `https://developer.microsoft.com/json-schemas/copilot/declarative-agent/{{version}}/schema.json`,
+    },
+    api_plugin_manifest: {
+        baseUrl: `https://developer.microsoft.com/json-schemas/copilot/plugin/{{version}}/schema.json`,
+    },
+};
+/**
+ * Cache for previously fetched schemas
+ */
+const schemaCache = {};
+/**
+ * Clear the schema cache
+ */
+function clearSchemaCache() {
+    Object.keys(schemaCache).forEach((key) => {
+        delete schemaCache[key];
+    });
+}
+exports.clearSchemaCache = clearSchemaCache;
+/**
+ * Fetch schema from the appropriate repository
+ * @param schemaName The type of schema to fetch
+ * @param schemaVersion The version of the schema to fetch
+ * @returns The requested schema as a JSON object with schema_url and content properties
+ */
+async function fetchSchema(schemaName, schemaVersion) {
+    // Create a cache key
+    const cacheKey = `${schemaName}:${schemaVersion}`;
+    // Check if we have this schema in cache
+    if (schemaCache[cacheKey]) {
+        return schemaCache[cacheKey];
+    }
+    const repository = schemaRepositories[schemaName];
+    if (!repository) {
+        return `Unknown schema name: ${schemaName}`;
+    }
+    try {
+        const url = repository.baseUrl.replace("{{version}}", schemaVersion);
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`HTTP error with status: ${response.status}`);
+        }
+        const content = await response.json();
+        const result = JSON.stringify({
+            schema_url: url,
+            content: content,
+        });
+        // Save to cache
+        schemaCache[cacheKey] = result;
+        return result;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return `Failed fetching schema at version: ${schemaVersion}, error: ${errorMessage}. Try different version.`;
+    }
+}
+exports.fetchSchema = fetchSchema;
+//# sourceMappingURL=fetcher.js.map

package/dist/fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.js","sourceRoot":"","sources":["../src/fetcher.ts"],"names":[],"mappings":";;;AAAA,uCAAuC;AACvC,kCAAkC;AAClC,6BAAwB;AAExB;;GAEG;AACU,QAAA,cAAc,GAAG,OAAC,CAAC,IAAI,CAAC;IACnC,cAAc;IACd,4BAA4B;IAC5B,qBAAqB;CACtB,CAAC,CAAC;AAUH;;GAEG;AACH,MAAM,kBAAkB,GAAyC;IAC/D,YAAY,EAAE;QACZ,OAAO,EAAE,2FAA2F;KACrG;IACD,0BAA0B,EAAE;QAC1B,OAAO,EAAE,gGAAgG;KAC1G;IACD,mBAAmB,EAAE;QACnB,OAAO,EAAE,qFAAqF;KAC/F;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,GAAwB,EAAE,CAAC;AAE5C;;GAEG;AACH,SAAgB,gBAAgB;IAC9B,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACvC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAJD,4CAIC;AAED;;;;;GAKG;AACI,KAAK,UAAU,WAAW,CAAC,UAAsB,EAAE,aAAqB;IAC7E,qBAAqB;IACrB,MAAM,QAAQ,GAAG,GAAG,UAAU,IAAI,aAAa,EAAE,CAAC;IAElD,wCAAwC;IACxC,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE;QACzB,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;KAC9B;IAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,EAAE;QACf,OAAO,wBAAwB,UAAU,EAAE,CAAC;KAC7C;IAED,IAAI;QACF,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QACrE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAElC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;YAChB,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;SAC/D;QAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEtC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC;YAC5B,UAAU,EAAE,GAAG;YACf,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;QAEH,gBAAgB;QAChB,WAAW,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC;QAE/B,OAAO,MAAM,CAAC;KACf;IAAC,OAAO,KAAK,EAAE;QACd,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,OAAO,sCAAsC,aAAa,YAAY,YAAY,0BAA0B,CAAC;KAC9G;AACH,CAAC;AArCD,kCAqCC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const server_1 = require("./server");
+async function main() {
+    const server = (0, server_1.createServer)();
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Fatal error in main():", error);
+    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":";;AAGA,wEAAiF;AAEjF,qCAAwC;AAExC,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAc,IAAA,qBAAY,GAAE,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createServer = void 0;
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const zod_1 = require("zod");
+const fetcher_1 = require("./fetcher");
+function createServer() {
+    const server = new mcp_js_1.McpServer({
+        name: "m365agentstoolkit-mcp",
+        version: "0.1.0",
+    });
+    server.tool("get_schema", 'Get the schema for "App manifest", "Declarative agent manifest", "API plugin manifest", use it everytime before understanding, modifying or creating any of these manifest files.', {
+        schema_name: fetcher_1.SchemaTypeEnum.describe("name of schema"),
+        schema_version: zod_1.z.string().describe("version of schema"),
+    }, async ({ schema_name, schema_version }) => {
+        const schema = await (0, fetcher_1.fetchSchema)(schema_name, schema_version);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: schema,
+                },
+            ],
+        };
+    });
+    return server;
+}
+exports.createServer = createServer;
+//# 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,uCAAuC;AACvC,kCAAkC;AAClC,oEAAoE;AACpE,6BAAwB;AACxB,uCAAwD;AAExD,SAAgB,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,kBAAS,CAAC;QAC3B,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CACT,YAAY,EACZ,mLAAmL,EACnL;QACE,WAAW,EAAE,wBAAc,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QACtD,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;KACzD,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE,EAAE;QACxC,MAAM,MAAM,GAAG,MAAM,IAAA,qBAAW,EAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QAE9D,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM;iBACb;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AA3BD,oCA2BC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@microsoft/m365agentstoolkit-mcp",
+  "version": "0.1.0-alpha.18ed8019e.0",
+  "scripts": {
+    "build": "tsc && shx chmod +x dist/index.js",
+    "watch": "tsc --watch",
+    "start": "node ./dist/index.js",
+    "test:unit": "jest",
+    "lint": "eslint \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "lint:staged": "lint-staged",
+    "lint:fix": "eslint --fix \"src/**/*.ts\" \"tests/**/*.ts\""
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "mcp"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OfficeDev/teams-toolkit.git"
+  },
+  "author": "Microsoft Corporation",
+  "license": "MIT",
+  "description": "MCP server for Microsoft 365 Agents Toolkit",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.9.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@istanbuljs/nyc-config-typescript": "^1.0.2",
+    "@types/jest": "^29.5.13",
+    "@types/node": "^20.10.0",
+    "@types/sinon": "^17.0.4",
+    "@typescript-eslint/eslint-plugin": "^4.19.0",
+    "@typescript-eslint/parser": "^4.19.0",
+    "chai": "^5.2.0",
+    "eslint": "^7.29.0",
+    "eslint-plugin-header": "^3.1.1",
+    "eslint-plugin-import": "^2.25.2",
+    "eslint-plugin-no-secrets": "^0.8.9",
+    "eslint-plugin-prettier": "^4.0.0",
+    "jest": "^29.7.0",
+    "jest-environment-node": "^29.7.0",
+    "nock": "^14.0.4",
+    "prettier": "^2.4.1",
+    "shx": "^0.3.4",
+    "sinon": "^20.0.0",
+    "ts-jest": "29.2.5",
+    "ts-node": "^9.1.1",
+    "typescript": "^4.4.4"
+  },
+  "lint-staged": {
+    "*.{js,jsx,css,ts,tsx}": [
+      "npx eslint --cache --fix --quiet"
+    ]
+  },
+  "gitHead": "2b0fdff8334c5e67cb619e471d44a5fe463b02fa"
+}