fa-mcp-sdk 0.3.2 → 0.3.3

package/README.md

@@ -223,14 +223,22 @@ Note: The `dist/` directory (compiled JavaScript) is created after running `npm
 Built-in chat interface for testing MCP server tools using an AI agent (OpenAI-compatible LLM).
 The agent automatically discovers available tools and calls them in a conversational loop.
 
-To enable, set environment variables:
+To enable, set environment variables (`.env` or shell):
 ```
 AGENT_TESTER_ENABLED=true
 AGENT_TESTER_OPENAI_API_KEY=sk-...
 ```
 
+Or configure in `config/default.yaml` (or `local.yaml`):
+```yaml
+agentTester:
+  enabled: true
+  openAi:
+    apiKey: sk-...
+```
+
 The tester UI is available at `http://localhost:<port>/agent-tester` and auto-connects to the local MCP server.
-Supports custom LLM endpoints, configurable system prompts, and dynamic HTTP headers.
+Supports custom LLM endpoints, configurable system prompts, and dynamic HTTP headers. Recommended model for testing: **gpt-5.2**.
 
 ## Directory Requirements
 

package/cli-template/CLAUDE.md

@@ -112,6 +112,26 @@ Detailed fa-mcp-sdk docs are in `FA-MCP-SDK-DOC/`:
 
 The Agent Tester validates the full agent experience: how the LLM interprets tool descriptions, selects tools, passes arguments, and presents results. → See `08-agent-tester-and-headless-api.md` for complete API reference.
 
+### Prerequisites
+
+Agent Tester requires an OpenAI API key to call the LLM. Before using it, ensure the following configuration is in place:
+
+**Option A** — environment variables (`.env` file or shell):
+```
+AGENT_TESTER_ENABLED=true
+AGENT_TESTER_OPENAI_API_KEY=sk-...
+```
+
+**Option B** — `config/default.yaml` (or `local.yaml`):
+```yaml
+agentTester:
+  enabled: true
+  openAi:
+    apiKey: sk-...
+```
+
+**IMPORTANT for Claude Code**: Before running any Agent Tester tests (Headless API or Playwright), verify that the OpenAI API key is configured. Check `.env` for `AGENT_TESTER_OPENAI_API_KEY` or `config/default.yaml` / `config/local.yaml` for `agentTester.openAi.apiKey`. If the key is missing or empty, inform the user that Agent Tester cannot function without it and ask them to provide the key.
+
 ### What Gets Tested
 
 - **Tool architecture** — correct tool decomposition (split or merge?)

package/cli-template/package.json

@@ -49,7 +49,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.2",
     "dotenv": "^17.2.3",
-    "fa-mcp-sdk": "^0.3.2"
+    "fa-mcp-sdk": "^0.3.3"
   },
   "devDependencies": {
     "@types/express": "^5.0.6",

package/cli-template/prompt-example-new-MCP.md

@@ -37,7 +37,7 @@ accessPoints:
   currencyService:
     host: smart-trade-ml.com
     port: 5002
-    token: '***' 
+    token: '***'
 ```
 
 
@@ -51,6 +51,11 @@ accessPoints:
    currencyService:
       token: '88888888-4444-4444-4444-bbbbbbbbbbbb'
 
+agentTester:
+   enabled: true
+   openAi:
+      apiKey: '<ask the user for the key>'
+
 consul:
    service:
       enable: false
@@ -67,14 +72,6 @@ webServer:
       type: 'permanentServerTokens'
 ```
 
-
-### Code Style
-Write code concisely. Avoid unnecessary logging.
-Follow DRY and KISS principles.
-
-### Use the fa-mcp-sdk agent
-Follow the recommendations in the file `FA-MCP-SDK-DOC/00-FA-MCP-SDK-index.md`
-
 # Task
 
 1) Instead of the test tool 'example_tool', add a tool to get the current currency cross-rate.
@@ -82,7 +79,11 @@ Follow the recommendations in the file `FA-MCP-SDK-DOC/00-FA-MCP-SDK-index.md`
 - quoteCurrency - Currency code (ISO 4217 code Alpha-3) - required parameter
 - baseCurrency - Currency code (ISO 4217 code Alpha-3) - optional parameter, default is USD
 
-2) Replace file content `src/asset/logo.svg` with
+2) Instead of the test resource 'custom-resource://resource1', add a resource to get the list of available currencies
+
+3) Instead of the endpoint /api/example (/example) in the file `src/api/router.ts`, create the endpoint get-curr-rate as a proxy to http://<appConfig.accessPoints.currencyService.host>:<appConfig.accessPoints.currencyService.port>/currency-service/?rate=<QUOTE_CURRENCY><BASE_CURRENCY>
+
+4) Replace file content `src/asset/logo.svg` with
 ```
 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
   <path fill="currentColor"
@@ -90,10 +91,6 @@ Follow the recommendations in the file `FA-MCP-SDK-DOC/00-FA-MCP-SDK-index.md`
 </svg>
 ```
 
-3) Instead of the test resource 'custom-resource://resource1', add a resource to get the list of available currencies
-
-4) Instead of the test examples in `tests/mcp/test-cases.js`, write tests for our case
-
-5) Formulate the prompt AGENT_BRIEF in `src/prompts/agent-brief.ts` and AGENT_PROMPT in src/prompts/agent-prompt.ts
+5) Formulate the prompt AGENT_BRIEF in `src/prompts/agent-brief.ts` and AGENT_PROMPT in `src/prompts/agent-prompt.ts`
 
-6) Instead of the endpoint /api/example (/example) in the file `src/api/router.ts`, create the endpoint get-curr-rate as a proxy to http://<appConfig.accessPoints.currencyService.host>:<appConfig.accessPoints.currencyService.port>/currency-service/?rate=<QUOTE_CURRENCY><BASE_CURRENCY>
+6) Instead of the test examples in `tests/mcp/test-cases.js`, write tests for our case

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fa-mcp-sdk",
   "productName": "FA MCP SDK",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Core infrastructure and templates for building Model Context Protocol (MCP) servers with TypeScript",
   "type": "module",
   "main": "dist/core/index.js",