feat: enhance plugin system with new lifecycle hooks and utilities

- Introduced a new `plugin-types.ts` file to define plugin interfaces and context types.
- Added utility functions in `plugin-utils.ts` for plugin management, including validation and loading.
- Refactored existing plugins to use the new plugin system, including `config-plugin.ts`, `visibility-plugin.ts`, and `logging-plugin.ts`.
- Updated the `ComposableMCPServer` class to support new plugin lifecycle hooks such as `configureServer`, `transformTool`, and `composeEnd`.
- Improved the `loadPlugin` function to handle query parameters for dynamic plugin configuration.
- Enhanced the `large-result` and `search-tool` plugins to utilize the new plugin structure and lifecycle methods.
- Updated the `set-up-mcp-compose.ts` to reflect changes in plugin loading and configuration.

Author: yaonyan

packages/core/deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcpc/core",
-  "version": "0.1.2",
+  "version": "0.1.3-beta.plugin-params",
   "tasks": {
     "server:compile": "echo \"no need to compile\"",
     "test": "deno test --allow-env --allow-read tests/",

packages/core/examples/11-large-result-plugin-demo.ts

@@ -7,7 +7,7 @@
 
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { mcpc } from "../src/set-up-mcp-compose.ts";
-import { createLargeResultPlugin } from "../plugins.ts";
+// import { createLargeResultPlugin } from "../plugins.ts";
 import { jsonSchema } from "ai";
 
 const server = await mcpc(
@@ -17,7 +17,11 @@ const server = await mcpc(
       name: "large-output-handler",
       description:
         "Agent that demonstrates automatic large output handling and file storage",
-      plugins: [createLargeResultPlugin()],
+      plugins: [
+        "./plugins/large-result.ts?maxSize=8000&previewSize=4000",
+        // create a large result plugin instance
+        // createLargeResultPlugin(),
+      ],
     },
   ],
   (server) => {
@@ -39,9 +43,9 @@ const server = await mcpc(
         }
         return { content: [{ type: "text", text }] };
       },
-      { internal: true },
+      { internal: true }
     );
-  },
+  }
 );
 
 const transport = new StdioServerTransport();

packages/core/plugins.ts

@@ -28,7 +28,7 @@
  * import largeResultPlugin from "@mcpc/core/plugins/large-result";
  *
  * const server = await mcpc([...], [...]);
- * 
+ *
  * // Use plugins with default settings
  * await server.addPlugin(searchPlugin);
  * await server.addPlugin(largeResultPlugin);
@@ -46,5 +46,4 @@ export { default as defaultSearchPlugin } from "./src/plugins/search-tool.ts";
 export { default as defaultLargeResultPlugin } from "./src/plugins/large-result.ts";
 
 // Export plugin types for advanced users
-export type { ToolPlugin } from "./src/compose.ts";
 export type { SearchOptions } from "./src/plugins/search-tool.ts";