feat: Add env support + small fixes

.env.example

@@ -32,5 +32,5 @@ ASK262_EMBEDDING_PROVIDER=ollama
 # HTTP SERVER CONFIGURATION
 # =============================================================================
 
-# Port for the HTTP MCP server (optional, defaults to 3000)
+# Port for the HTTP MCP server (optional, defaults to 8081)
-# ASK262_PORT=3000
+# ASK262_PORT=8081

.vscode/launch.json

@@ -5,7 +5,7 @@
       "name": "Debug: MCP Server",
       "type": "bun",
       "request": "launch",
-      "program": "${workspaceFolder}/src/mcp-server.ts",
+      "program": "${workspaceFolder}/src/mcp-server-stdio.ts",
       "cwd": "${workspaceFolder}",
       "stopOnEntry": false,
       "watchMode": false

AGENTS.md

@@ -37,7 +37,7 @@ ask262/
 │       ├── htmlAddInternalMethodLink.ts  # Adds internal method links
 │       ├── text-splitters/   # Text chunking utilities
 │       └── utils/            # Formatting utilities
-│   ├── mcp-server.ts         # MCP server for external tool integration
+│   ├── mcp-server-stdio.ts   # MCP server (stdio transport)
 │   └── test/                 # Manual verification tests
 │       └── manual/
 │           ├── verify-db.ts              # Verify database contents
@@ -65,7 +65,7 @@ bun test                # Run all tests
 bun run test-evaluate   # Test evaluate in engine262 tool
 bun run test-search-spec-sections "query"  # Test vector search tool with query
 bun run agent "Query"   # Run agent with question
-bun run mcp-server      # Start MCP server (stdio transport)
+bun run ask262-stdio    # Start MCP server (stdio transport)
 bun run test-mcp-server # Test MCP server with all tools
 ```
 
@@ -91,7 +91,7 @@ Add to your MCP client configuration:
   "mcpServers": {
     "ask262": {
       "command": "bun",
-      "args": ["run", "/path/to/ask262/src/mcp-server.ts"],
+      "args": ["run", "/path/to/ask262/src/mcp-server-stdio.ts"],
       "cwd": "/path/to/ask262"
     }
   }
@@ -107,7 +107,7 @@ Add to your MCP client configuration:
   "mcp": {
     "ask262": {
       "type": "local",
-      "command": ["bun", "run", "src/mcp-server.ts"],
+      "command": ["bun", "run", "src/mcp-server-stdio.ts"],
       "enabled": true,
       "environment": {
         "OLLAMA_HOST": "http://localhost:11434"
@@ -124,7 +124,7 @@ Add to your MCP client configuration:
   "mcp": {
     "ask262": {
       "type": "remote",
-      "url": "http://localhost:3000/mcp",
+      "url": "http://localhost:8081/mcp",
       "enabled": true
     }
   }
@@ -133,7 +133,7 @@ Add to your MCP client configuration:
 
 Start the HTTP server first:
 ```bash
-bun run mcp-http        # Development
+bun run ask262-http     # Development
 ask262-http             # After npm install -g
 ```
 

Readme.md

@@ -31,7 +31,7 @@ nano .env  # or use your preferred editor
 - `ASK262_EMBEDDING_PROVIDER`: Choose `ollama` (local) or `fireworks` (cloud). Default: `ollama`
 - `OLLAMA_HOST`: Ollama server URL. Default: `http://localhost:11434`
 - `FIREWORKS_API_KEY`: Required if using Fireworks. Get from https://app.fireworks.ai
-- `ASK262_PORT`: HTTP server port. Default: `3000`
+- `ASK262_PORT`: HTTP server port. Default: `8081`
 
 **Example `.env`:**
 ```bash
@@ -98,7 +98,7 @@ Add to your MCP client configuration using `bunx` (no installation required):
   "mcp": {
     "ask262": {
       "type": "remote",
-      "url": "http://localhost:3000/mcp",
+      "url": "http://localhost:8081/mcp",
       "enabled": true
     }
   }
@@ -107,7 +107,7 @@ Add to your MCP client configuration using `bunx` (no installation required):
 
 Start the HTTP server first:
 ```bash
-bun run mcp-http        # Development
+bun run ask262-http     # Development
 ask262-http             # After npm install -g
 # Or with custom port:
 ASK262_PORT=8080 ask262-http

package.json

@@ -7,9 +7,9 @@
     "bun": ">=1.0.0"
   },
   "type": "module",
-  "main": "src/mcp-server.ts",
+  "main": "src/mcp-server-stdio.ts",
   "bin": {
-    "ask262": "src/mcp-server.ts",
+    "ask262": "src/mcp-server-stdio.ts",
     "ask262-http": "src/mcp-server-http.ts"
   },
   "scripts": {
@@ -24,7 +24,8 @@
     "test-evaluate-timeout": "bun run src/test/manual/test-evaluate-timeout.ts",
     "test-search-spec-sections": "bun run src/test/manual/test-search-spec-sections.ts",
     "test-mcp-server": "bun run src/test/manual/test-mcp-server.ts",
-    "mcp-http": "bun run src/mcp-server-http.ts",
+    "ask262-stdio": "bun run src/mcp-server-stdio.ts",
+    "ask262-http": "bun run src/mcp-server-http.ts",
     "test": "bun test",
     "prepublish": "npm run type-check && npm run lint && npm pack --dry-run",
     "release": "bash scripts/release.sh --patch"

src/lib/embeddings-factory.ts

@@ -38,7 +38,7 @@ export function createEmbeddings(provider?: EmbeddingProvider): Embeddings {
 
   switch (selectedProvider) {
     case "ollama": {
-      console.log("[Embeddings] Using Ollama provider");
+      console.error("[Embeddings] Using Ollama provider");
       return new OllamaEmbeddings({
         model: OLLAMA_EMBEDDING_MODEL,
         baseUrl: process.env.OLLAMA_HOST,
@@ -50,7 +50,7 @@ export function createEmbeddings(provider?: EmbeddingProvider): Embeddings {
       if (!apiKey) {
         throw new Error("FIREWORKS_API_KEY environment variable is required");
       }
-      console.log("[Embeddings] Using Fireworks provider");
+      console.error("[Embeddings] Using Fireworks provider");
       return new FireworksEmbeddings({
         apiKey,
         modelName: FIREWORKS_EMBEDDING_MODEL,

src/mcp-server-http.ts

@@ -43,8 +43,8 @@ const STORAGE_DIR = path.resolve(__dirname, "..", STORAGE_DIR_REL);
 // Initialize embeddings based on ASK262_EMBEDDING_PROVIDER env var
 const embeddings = createEmbeddings();
 
-// Server port (default: 3000)
+// Server port (default: 8081)
-const PORT = Number(process.env.ASK262_PORT) || 3000;
+const PORT = Number(process.env.ASK262_PORT) || 8081;
 
 /**
  * Factory function to create a fresh MCP server instance.

src/test/manual/test-mcp-server.ts

@@ -9,7 +9,7 @@ import type {
   EvaluateToolMCPOutput,
   GetSectionContentMCPOutput,
   SearchSpecMCPOutput,
-} from "../../mcp-server.js";
+} from "../../mcp-server-stdio.js";
 
 async function testMCPServer() {
   console.log("Starting MCP Server tests...\n");
@@ -17,7 +17,7 @@ async function testMCPServer() {
   // Create transport connecting to the server
   const transport = new StdioClientTransport({
     command: "bun",
-    args: ["run", "src/mcp-server.ts"],
+    args: ["run", "src/mcp-server-stdio.ts"],
   });
 
   // Create client