@aigne/example-mcp-server 0.0.1-0

package/.env.local.example

@@ -0,0 +1,44 @@
+# Change the name of this file to .env.local and fill in the following values
+
+# Uncomment the lines below to enable debug logging
+# DEBUG="aigne:*"
+
+# Use different Models
+
+# OpenAI
+MODEL="openai:gpt-4.1"
+OPENAI_API_KEY="YOUR_OPENAI_API_KEY"
+
+# Anthropic claude
+# MODEL="anthropic:claude-3-7-sonnet-latest"
+# ANTHROPIC_API_KEY=""
+
+# Gemini
+# MODEL="gemini:gemini-2.0-flash"
+# GEMINI_API_KEY=""
+
+# Bedrock nova
+# MODEL=bedrock:us.amazon.nova-premier-v1:0
+# AWS_ACCESS_KEY_ID=""
+# AWS_SECRET_ACCESS_KEY=""
+# AWS_REGION=us-west-2
+
+# DeepSeek
+# MODEL="deepseek:deepseek-chat"
+# DEEPSEEK_API_KEY=""
+
+# OpenRouter
+# MODEL="openrouter:openai/gpt-4o"
+# OPEN_ROUTER_API_KEY=""
+
+# xAI
+# MODEL="xai:grok-2-latest"
+# XAI_API_KEY=""
+
+# Ollama
+# MODEL="ollama:llama3.2"
+# OLLAMA_DEFAULT_BASE_URL="http://localhost:11434/v1";
+
+
+# Setup proxy if needed
+# HTTPS_PROXY=http://localhost:7890

package/LICENSE.md

@@ -0,0 +1,93 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/README.md

@@ -0,0 +1,89 @@
+# Chatbot Example
+
+This example demonstrates how to create and run an agent-based chatbot using the [AIGNE Framework](https://github.com/AIGNE-io/aigne-framework) and [AIGNE CLI](https://github.com/AIGNE-io/aigne-framework/blob/main/packages/cli/README.md). The example now supports both one-shot and interactive chat modes, along with customizable model settings and pipeline input/output.
+
+## Prerequisites
+
+* [Node.js](https://nodejs.org) and npm installed on your machine
+* An [OpenAI API key](https://platform.openai.com/api-keys) for interacting with OpenAI's services
+
+## Quick Start (No Installation Required)
+
+```bash
+export OPENAI_API_KEY=YOUR_OPENAI_API_KEY # Set your OpenAI API key
+
+# Run in one-shot mode (default)
+npx -y @aigne/example-chat-bot
+
+# Run in interactive chat mode
+npx -y @aigne/example-chat-bot --chat
+
+# Use pipeline input
+echo "Tell me about AIGNE Framework" | npx -y @aigne/example-chat-bot
+```
+
+## Installation
+
+### Install AIGNE CLI
+
+```bash
+npm install -g @aigne/cli
+```
+
+### Clone the Repository
+
+```bash
+git clone https://github.com/AIGNE-io/aigne-framework
+
+cd aigne-framework/examples/chat-bot
+```
+
+### Setup Environment Variables
+
+Setup your OpenAI API key in the `.env.local` file (you can rename `.env.local.example` to `.env.local`):
+
+```bash
+OPENAI_API_KEY="" # Set your OpenAI API key here
+```
+
+#### Using Different Models
+
+You can use different AI models by setting the `MODEL` environment variable along with the corresponding API key. The framework supports multiple providers:
+
+* **OpenAI**: `MODEL="openai:gpt-4.1"` with `OPENAI_API_KEY`
+* **Anthropic**: `MODEL="anthropic:claude-3-7-sonnet-latest"` with `ANTHROPIC_API_KEY`
+* **Google Gemini**: `MODEL="gemini:gemini-2.0-flash"` with `GEMINI_API_KEY`
+* **AWS Bedrock**: `MODEL="bedrock:us.amazon.nova-premier-v1:0"` with AWS credentials
+* **DeepSeek**: `MODEL="deepseek:deepseek-chat"` with `DEEPSEEK_API_KEY`
+* **OpenRouter**: `MODEL="openrouter:openai/gpt-4o"` with `OPEN_ROUTER_API_KEY`
+* **xAI**: `MODEL="xai:grok-2-latest"` with `XAI_API_KEY`
+* **Ollama**: `MODEL="ollama:llama3.2"` with `OLLAMA_DEFAULT_BASE_URL`
+
+For detailed configuration examples, please refer to the `.env.local.example` file in this directory.
+
+### Run the Example
+
+```bash
+aigne run # Run in one-shot mode (default)
+
+# Run in interactive chat mode
+aigne run --chat
+
+# Use pipeline input
+echo "Tell me about AIGNE Framework" | aigne run
+```
+
+### 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 |

package/agents/current-time.js

@@ -0,0 +1,5 @@
+export default function currentTime() {
+  return {
+    currentTime: new Date().toISOString(),
+  };
+}

package/agents/poet.yaml

@@ -0,0 +1,16 @@
+name: poet
+description: AI Poetry Writing Agent
+instructions: |
+  You are a creative and thoughtful AI poet. You write beautiful, imaginative, and emotionally resonant poetry based on the given topic or prompt.
+  Use vivid imagery, metaphor, and elegant language. Your poems can follow any style or form, including free verse, haiku, or sonnet.
+  Be expressive and human-like in tone.
+
+  Write a poem about {{topic}}.
+input_schema:
+  type: object
+  properties:
+    topic:
+      type: string
+      description: The topic or theme for the poem.
+  required:
+    - topic

package/agents/system-info.js

@@ -0,0 +1,12 @@
+import os from "node:os";
+
+export default function systemInfo() {
+  return {
+    platform: os.platform(),
+    arch: os.arch(),
+    cpuCount: os.cpus().length,
+    totalMemory: `${(os.totalmem() / 1024 / 1024 / 1024).toFixed(2)} GB`,
+    freeMemory: `${(os.freemem() / 1024 / 1024 / 1024).toFixed(2)} GB`,
+    uptime: `${Math.floor(os.uptime() / 60)} min`,
+  };
+}

package/aigne.yaml

@@ -0,0 +1,7 @@
+chat_model:
+  name: gpt-4.1
+  temperature: 0.8
+agents:
+  - agents/poet.yaml
+  - agents/current-time.js
+  - agents/system-info.js

package/index.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "node:child_process";
+import { argv } from "node:process";
+
+spawnSync("aigne", [...argv.slice(2)], {
+  stdio: "inherit",
+  cwd: import.meta.dirname,
+});

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@aigne/example-mcp-server",
+  "version": "0.0.1-0",
+  "description": "A demonstration of using AIGNE CLI to build a MCP server",
+  "author": "Arcblock <blocklet@arcblock.io> https://github.com/blocklet",
+  "homepage": "https://github.com/AIGNE-io/aigne-framework/tree/main/examples/mcp-server",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AIGNE-io/aigne-framework"
+  },
+  "type": "module",
+  "bin": "index.js",
+  "dependencies": {
+    "@aigne/cli": "^1.18.0"
+  },
+  "scripts": {
+    "test": "aigne test",
+    "test:llm": "aigne run"
+  }
+}