converse-mcp-server 1.5.0 → 1.5.2

package/LICENSE

@@ -0,0 +1,19 @@
+Copyright 2025 Converse MCP Server Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,20 +1,22 @@
 # Converse MCP Server
 
+[![npm version](https://img.shields.io/npm/v/converse-mcp-server.svg)](https://www.npmjs.com/package/converse-mcp-server)
+
 A simplified, functional Node.js implementation of an MCP (Model Context Protocol) server with chat and consensus tools. Built with modern Node.js practices and official SDKs for seamless AI provider integration.
 
 ## 🚀 Quick Start
 
-### Option 1: Direct from GitHub (Recommended)
+### Option 1: Direct from NPM (Recommended)
 
 ```bash
 # Using npx (recommended)
-npx FallDownTheSystem/converse
+npx converse-mcp-server
 
 # Using pnpm dlx (alternative)
-pnpm dlx FallDownTheSystem/converse
+pnpm dlx converse-mcp-server
 
 # Using yarn dlx (alternative)  
-yarn dlx FallDownTheSystem/converse
+yarn dlx converse-mcp-server
 ```
 
 ### Option 2: Clone and Install
@@ -63,7 +65,6 @@ LOG_LEVEL=info
 MAX_MCP_OUTPUT_TOKENS=200000
 
 # Optional: Provider-specific settings
-GOOGLE_LOCATION=us-central1
 XAI_BASE_URL=https://api.x.ai/v1
 OPENROUTER_REFERER=https://github.com/FallDownTheSystem/converse
 ```
@@ -91,31 +92,7 @@ There are several ways to add the Converse MCP Server to Claude:
   "mcpServers": {
     "converse": {
       "command": "npx",
-      "args": ["FallDownTheSystem/converse"],
-      "env": {
-        "OPENAI_API_KEY": "your_key_here",
-        "GOOGLE_API_KEY": "your_key_here",
-        "XAI_API_KEY": "your_key_here",
-        "ANTHROPIC_API_KEY": "your_key_here",
-        "MISTRAL_API_KEY": "your_key_here",
-        "DEEPSEEK_API_KEY": "your_key_here",
-        "OPENROUTER_API_KEY": "your_key_here",
-        "OPENROUTER_REFERER": "https://github.com/YourUsername/YourApp",
-        "MAX_MCP_OUTPUT_TOKENS": "200000"
-      }
-    }
-  }
-}
-```
-
-#### Option B: Using NPX with stdio transport
-
-```json
-{
-  "mcpServers": {
-    "converse": {
-      "command": "npx",
-      "args": ["FallDownTheSystem/converse", "--transport", "stdio"],
+      "args": ["converse-mcp-server"],
       "env": {
         "OPENAI_API_KEY": "your_key_here",
         "GOOGLE_API_KEY": "your_key_here",
@@ -132,7 +109,7 @@ There are several ways to add the Converse MCP Server to Claude:
 }
 ```
 
-#### Option C: Direct Node.js execution
+#### Option B: Direct Node.js execution
 
 ```json
 {
@@ -140,9 +117,7 @@ There are several ways to add the Converse MCP Server to Claude:
     "converse": {
       "command": "node",
       "args": [
-        "C:\\Users\\YourUsername\\Documents\\Projects\\converse\\src\\index.js",
-        "--transport",
-        "stdio"
+        "C:\\Users\\YourUsername\\Documents\\Projects\\converse\\src\\index.js"
       ],
       "env": {
         "OPENAI_API_KEY": "your_key_here",
@@ -160,27 +135,7 @@ There are several ways to add the Converse MCP Server to Claude:
 }
 ```
 
-#### Option D: Using environment variable for transport
-
-```json
-{
-  "mcpServers": {
-    "converse": {
-      "command": "npx",
-      "args": ["FallDownTheSystem/converse"],
-      "env": {
-        "MCP_TRANSPORT": "stdio",
-        "OPENAI_API_KEY": "your_key_here",
-        "GOOGLE_API_KEY": "your_key_here",
-        "XAI_API_KEY": "your_key_here",
-        "MAX_MCP_OUTPUT_TOKENS": "200000"
-      }
-    }
-  }
-}
-```
-
-#### Option E: Local HTTP Development (Advanced)
+#### Option C: Local HTTP Development (Advanced)
 
 For local development with HTTP transport (optional, for debugging):
 
@@ -207,9 +162,16 @@ For local development with HTTP transport (optional, for debugging):
 #### Installation Steps
 
 1. **For Claude Code**: 
-   - Open the command palette (Ctrl/Cmd + Shift + P)
-   - Run "Claude Code: Edit MCP Settings"
-   - Add one of the configurations above
+   ```bash
+   # Add the server globally (for all projects)
+   claude mcp add converse npx converse-mcp-server -s user
+   
+   # Then set your API keys
+   claude mcp set-env converse OPENAI_API_KEY=your_key_here -s user
+   claude mcp set-env converse GOOGLE_API_KEY=your_key_here -s user
+   claude mcp set-env converse XAI_API_KEY=your_key_here -s user
+   # Add other API keys as needed
+   ```
 
 2. **For Claude Desktop**:
    - Navigate to Settings → Developer → MCP Servers
@@ -291,7 +253,9 @@ Programmatic access to documentation:
 ### OpenAI Models
 - **o3**: Strong reasoning (200K context)
 - **o3-mini**: Fast O3 variant (200K context)  
+- **o3-pro**: Professional-grade reasoning (200K context) - EXTREMELY EXPENSIVE
 - **o4-mini**: Latest reasoning model (200K context)
+- **gpt-4.1**: Advanced reasoning (1M context)
 - **gpt-4o**: Multimodal flagship (128K context)
 - **gpt-4o-mini**: Fast multimodal (128K context)
 
@@ -299,12 +263,34 @@ Programmatic access to documentation:
 - **gemini-2.5-flash** (alias: `flash`): Ultra-fast (1M context)
 - **gemini-2.5-pro** (alias: `pro`): Deep reasoning (1M context)
 - **gemini-2.0-flash**: Latest with experimental thinking
+- **gemini-2.0-flash-lite**: Lightweight fast model, text-only
 
 ### X.AI/Grok Models  
 - **grok-4-0709** (alias: `grok`): Latest advanced model (256K context)
 - **grok-3**: Previous generation (131K context)
 - **grok-3-fast**: Higher performance variant
 
+### Anthropic Models
+- **claude-opus-4**: Highest intelligence with extended thinking (200K context)
+- **claude-sonnet-4**: Balanced performance with extended thinking (200K context)
+- **claude-3.7-sonnet**: Enhanced 3.x generation with thinking (200K context)
+- **claude-3.5-sonnet**: Fast and intelligent (200K context)
+- **claude-3.5-haiku**: Fastest model for simple queries (200K context)
+
+### Mistral Models
+- **magistral-medium**: Frontier-class reasoning model (40K context)
+- **magistral-small**: Small reasoning model (40K context)
+- **mistral-medium-3**: Frontier-class multimodal model (128K context)
+
+### DeepSeek Models
+- **deepseek-chat**: Strong MoE model with 671B/37B parameters (64K context)
+- **deepseek-reasoner**: Advanced reasoning model with CoT (64K context)
+
+### OpenRouter Models
+- **qwen3-235b-thinking**: Qwen3 with enhanced reasoning (32K context)
+- **qwen3-coder**: Specialized for programming tasks (32K context)
+- **kimi-k2**: Moonshot AI Kimi K2 with extended context (200K context)
+
 ## 🚀 Development
 
 ### Install from Source
@@ -342,8 +328,12 @@ npm run kill-server    # Kill any server running on port 3157
 npm test               # Run all tests
 npm run test:unit      # Unit tests only
 npm run test:integration # Integration tests
+npm run test:mcp-client # MCP client tests (HTTP-based client-server testing)
 npm run test:real-api  # Real API tests (requires keys)
+npm run test:providers # Provider tests
+npm run test:tools     # Tool tests
 npm run test:coverage  # Coverage report
+npm run test:watch     # Run tests in watch mode
 
 # Code quality
 npm run lint           # Check code style
@@ -396,7 +386,7 @@ XAI_API_KEY=xai-...
 npm run test:real-api
 
 # Run comprehensive integration tests
-node final-integration-test.js
+node tests/integration/final-integration-test.js
 
 # Validate server functionality
 npm run validate
@@ -417,14 +407,14 @@ npm test
 npm run test:real-api
 
 # 4. Comprehensive validation
-node final-integration-test.js
+node tests/integration/final-integration-test.js
 ```
 
 **Expected Results:**
 - Server starts without errors on port 3157
 - All unit tests pass
 - Real API tests connect successfully (if keys configured)
-- Integration tests achieve >70% success rate
+- Some real API integration tests may occasionally timeout
 
 ## 📦 Publishing to NPM
 
@@ -530,7 +520,6 @@ converse/
 | `PORT` | Server port | `3157` | `3157` |
 | `LOG_LEVEL` | Logging level | `info` | `debug`, `info`, `error` |
 | `MAX_MCP_OUTPUT_TOKENS` | Token response limit | `25000` | `200000` |
-| `GOOGLE_LOCATION` | Google API region | `us-central1` | `us-central1` |
 | `XAI_BASE_URL` | XAI API endpoint | `https://api.x.ai/v1` | Custom endpoint |
 
 ### Model Selection

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "converse-mcp-server",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "description": "Converse MCP Server - Converse with other LLMs with chat and consensus tools",
   "type": "module",
   "main": "src/index.js",

package/src/providers/mistral.js

@@ -151,7 +151,7 @@ function convertMessagesToMistral(messages) {
           // Convert Anthropic/Claude format to Mistral format
           mistralContent.push({
             type: 'image_url',
-            image_url: `data:${item.source.media_type};base64,${item.source.data}`
+            imageUrl: `data:${item.source.media_type};base64,${item.source.data}`
           });
           debugLog(`[Mistral] Converting image: ${item.source.media_type}, data length: ${item.source.data.length}`);
         }