@aigne/example-mcp-server 0.3.89 → 0.3.90-beta.1

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [0.3.90-beta.1](https://github.com/AIGNE-io/aigne-framework/compare/example-mcp-server-v0.3.90-beta...example-mcp-server-v0.3.90-beta.1) (2025-12-08)
+
+
+### Bug Fixes
+
+* correct run example & doc improvements ([#707](https://github.com/AIGNE-io/aigne-framework/issues/707)) ([f98fc5d](https://github.com/AIGNE-io/aigne-framework/commit/f98fc5df28fd6ce6134128c2f0e5395c1554b740))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/cli bumped to 1.58.0-beta.1
+
+## [0.3.90-beta](https://github.com/AIGNE-io/aigne-framework/compare/example-mcp-server-v0.3.89...example-mcp-server-v0.3.90-beta) (2025-12-07)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/cli bumped to 1.58.0-beta
+
 ## [0.3.89](https://github.com/AIGNE-io/aigne-framework/compare/example-mcp-server-v0.3.89-beta...example-mcp-server-v0.3.89) (2025-12-06)
 
 

package/README.md

@@ -21,9 +21,9 @@ The [Model Context Protocol (MCP)](https://modelcontextprotocol.io) is an open s
 
 ## Quick Start (No Installation Required)
 
-```bash
-OPENAI_API_KEY="" # Set your OpenAI API key here
+### Run the Example
 
+```bash
 # Start the MCP server
 npx -y @aigne/example-mcp-server serve-mcp --port 3456
 
@@ -34,18 +34,46 @@ npx -y @aigne/example-mcp-server serve-mcp --port 3456
 
 This command will start the MCP server with the agents defined in this example
 
-### Using Different Models
+### Connect to an AI Model
+
+As an example, running `npx -y @aigne/example-mcp-server serve-mcp --port 3456` requires an AI model. If this is your first run, you need to connect one.
+
+![run example](./run-example.png)
+
+- Connect via the official AIGNE Hub
+
+Choose the first option and your browser will open the official AIGNE Hub page. Follow the prompts to complete the connection. If you're a new user, the system automatically grants 400,000 tokens for you to use.
+
+![connect to official aigne hub](../images/connect-to-aigne-hub.png)
+
+- Connect via a self-hosted AIGNE Hub
+
+Choose the second option, enter the URL of your self-hosted AIGNE Hub, and follow the prompts to complete the connection. If you need to set up a self-hosted AIGNE Hub, visit the Blocklet Store to install and deploy it: [Blocklet Store](https://store.blocklet.dev/blocklets/z8ia3xzq2tMq8CRHfaXj1BTYJyYnEcHbqP8cJ?utm_source=www.arcblock.io&utm_medium=blog_link&utm_campaign=default&utm_content=store.blocklet.dev#:~:text=%F0%9F%9A%80%20Get%20Started%20in%20Minutes).
+
+![connect to self hosted aigne hub](../images/connect-to-self-hosted-aigne-hub.png)
+
+- Connect via a third-party model provider
+
+Using OpenAI as an example, you can configure the provider's API key via environment variables. After configuration, run the example again:
+
+```bash
+export OPENAI_API_KEY="" # Set your OpenAI API key here
+```
+For more details on third-party model configuration (e.g., OpenAI, DeepSeek, Google Gemini), see [.env.local.example](./.env.local.example).
+
+After configuration, run the example again.
+
+### Debugging
+
+The `aigne observe` command starts a local web server to monitor and analyze agent execution data. It provides a user-friendly interface to inspect traces, view detailed call information, and understand your agent’s behavior during runtime. This tool is essential for debugging, performance tuning, and gaining insight into how your agent processes information and interacts with tools and models.
+
+Start the observation server.
+
+![aigne-observe-execute](../images/aigne-observe-execute.png)
 
-You can use different AI models by setting the `MODEL` environment variable along with the corresponding API key. The framework supports multiple providers:
+View a list of recent executions.
 
-* **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`
+![aigne-observe-list](../images/aigne-observe-list.png)
 
 ## Available Agents
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/example-mcp-server",
-  "version": "0.3.89",
+  "version": "0.3.90-beta.1",
   "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",
@@ -12,7 +12,7 @@
   "type": "module",
   "bin": "aigne.yaml",
   "dependencies": {
-    "@aigne/cli": "^1.57.3"
+    "@aigne/cli": "^1.58.0-beta.1"
   },
   "scripts": {
     "test": "aigne test",