@aigne/example-mcp-github 1.9.2 → 1.10.0

package/README.md

@@ -1,6 +1,6 @@
 # GitHub MCP Server Integration
 
-This is a demonstration of using [AIGNE Framework](https://github.com/AIGNE-io/aigne-framework) and [GitHub MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/github) to interact with GitHub repositories.
+This is a demonstration of using [AIGNE Framework](https://github.com/AIGNE-io/aigne-framework) and [GitHub MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/github) to interact with GitHub repositories. The example now supports both one-shot and interactive chat modes, along with customizable model settings and pipeline input/output.
 
 ```mermaid
 flowchart LR
@@ -108,9 +108,41 @@ GITHUB_TOKEN="" # Set your GitHub Personal Access Token here
 ### Run the Example
 
 ```bash
-pnpm start # Interactive chat interface
-# or
-pnpm example # Run predefined examples
+pnpm start # Run in one-shot mode (default)
+
+# Run in interactive chat mode
+pnpm start -- --chat
+
+# Use pipeline input
+echo "Search for repositories related to 'modelcontextprotocol'" | pnpm start
+```
+
+### Run Options
+
+The example supports the following command-line parameters:
+
+| Parameter | Description | Default |
+|-----------|-------------|---------|
+| `--chat` | Run in interactive chat mode | Disabled (one-shot mode) |
+| `--model <provider[:model]>` | AI model to use in format 'provider[:model]' where model is optional. Examples: 'openai' or 'openai:gpt-4o-mini' | openai |
+| `--temperature <value>` | Temperature for model generation | Provider default |
+| `--top-p <value>` | Top-p sampling value | Provider default |
+| `--presence-penalty <value>` | Presence penalty value | Provider default |
+| `--frequency-penalty <value>` | Frequency penalty value | Provider default |
+| `--log-level <level>` | Set logging level (ERROR, WARN, INFO, DEBUG, TRACE) | INFO |
+| `--input`, `-i <input>` | Specify input directly | None |
+
+#### Examples
+
+```bash
+# Run in chat mode (interactive)
+pnpm start -- --chat
+
+# Set logging level
+pnpm start -- --log-level DEBUG
+
+# Use pipeline input
+echo "Search for repositories related to 'modelcontextprotocol'" | pnpm start
 ```
 
 ## Example

package/index.ts

@@ -1,54 +1,49 @@
 #!/usr/bin/env bunwrapper
 
 import assert from "node:assert";
-import { runChatLoopInTerminal } from "@aigne/cli/utils/run-chat-loop.js";
-import { AIAgent, AIGNE, MCPAgent } from "@aigne/core";
-import { loadModel } from "@aigne/core/loader/index.js";
-import { logger } from "@aigne/core/utils/logger.js";
+import { runWithAIGNE } from "@aigne/cli/utils/run-with-aigne.js";
+import { AIAgent, MCPAgent } from "@aigne/core";
 
 const { GITHUB_TOKEN } = process.env;
 
 assert(GITHUB_TOKEN, "Please set the GITHUB_TOKEN environment variable");
 
-logger.enable(`aigne:mcp,${process.env.DEBUG}`);
-
-const model = await loadModel();
-
-const github = await MCPAgent.from({
-  command: "npx",
-  args: ["-y", "@modelcontextprotocol/server-github"],
-  env: {
-    GITHUB_TOKEN,
+await runWithAIGNE(
+  async () => {
+    const github = await MCPAgent.from({
+      command: "npx",
+      args: ["-y", "@modelcontextprotocol/server-github"],
+      env: {
+        GITHUB_TOKEN,
+      },
+    });
+
+    const agent = AIAgent.from({
+      instructions: `\
+  ## GitHub Interaction Assistant
+  You are an assistant that helps users interact with GitHub repositories.
+  You can perform various GitHub operations like:
+  1. Searching repositories
+  2. Getting file contents
+  3. Creating or updating files
+  4. Creating issues and pull requests
+  5. And many more GitHub operations
+
+  Always provide clear, concise responses with relevant information from GitHub.
+  `,
+      skills: [github],
+      memory: true,
+    });
+
+    return agent;
+  },
+  {
+    chatLoopOptions: {
+      welcome:
+        "Hello! I'm a chatbot that can help you interact with GitHub. Try asking me a question about GitHub repositories!",
+      defaultQuestion: "Search for repositories related to 'aigne-framework'",
+    },
   },
-});
-
-const aigne = new AIGNE({
-  model,
-  skills: [github],
-});
-
-const agent = AIAgent.from({
-  instructions: `\
-## GitHub Interaction Assistant
-You are an assistant that helps users interact with GitHub repositories.
-You can perform various GitHub operations like:
-1. Searching repositories
-2. Getting file contents
-3. Creating or updating files
-4. Creating issues and pull requests
-5. And many more GitHub operations
-
-Always provide clear, concise responses with relevant information from GitHub.
-`,
-  memory: true,
-});
-
-const userAgent = aigne.invoke(agent);
-
-await runChatLoopInTerminal(userAgent, {
-  welcome:
-    "Hello! I'm a chatbot that can help you interact with GitHub. Try asking me a question about GitHub repositories!",
-  defaultQuestion: "Search for repositories related to 'aigne-framework'",
-});
+);
 
 process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/example-mcp-github",
-  "version": "1.9.2",
+  "version": "1.10.0",
   "description": "A demonstration of using AIGNE Framework and GitHub MCP Server to interact with GitHub repositories",
   "author": "Arcblock <blocklet@arcblock.io> https://github.com/blocklet",
   "homepage": "https://github.com/AIGNE-io/aigne-framework/tree/main/examples/mcp-github",
@@ -16,13 +16,13 @@
     "README.md"
   ],
   "dependencies": {
-    "openai": "^4.97.0",
-    "zod": "^3.24.4",
-    "@aigne/cli": "^1.9.0",
-    "@aigne/core": "^1.14.0"
+    "@aigne/core": "^1.16.0",
+    "@aigne/cli": "^1.10.0",
+    "@aigne/openai": "^0.1.0"
   },
   "devDependencies": {
-    "@aigne/test-utils": "^0.2.0"
+    "@types/bun": "^1.2.9",
+    "@aigne/test-utils": "^0.3.0"
   },
   "scripts": {
     "start": "bun run index.ts",

package/usages.ts

@@ -1,6 +1,6 @@
 import assert from "node:assert";
 import { AIAgent, AIGNE, MCPAgent } from "@aigne/core";
-import { OpenAIChatModel } from "@aigne/core/models/openai-chat-model.js";
+import { OpenAIChatModel } from "@aigne/openai";
 
 const { OPENAI_API_KEY, GITHUB_TOKEN } = process.env;
 assert(OPENAI_API_KEY, "Please set the OPENAI_API_KEY environment variable");