npm package: @mseep/nsaf-mcp-server
Description: MCP server for Neuro-Symbolic Autonomy Framework (NSAF)
Latest version: 0.1.0

# NSAF MCP Server

This is a Model Context Protocol (MCP) server for the Neuro-Symbolic Autonomy Framework (NSAF). It allows AI assistants to interact with the NSAF framework through the MCP protocol.

> **Note:** This repository includes both the NSAF framework code and the MCP server implementation, making it a complete package that can be deployed and used anywhere.

> **Note:** This implementation uses a simplified version of the MCP protocol that doesn't require the official MCP SDK. It implements the core functionality needed to expose NSAF capabilities to AI assistants.

## Features

- Run NSAF evolution with customizable parameters
- Compare different NSAF agent architectures
- Integrate NSAF capabilities into AI assistants

## Prerequisites

- Node.js 18+ and npm
- Python 3.8+ with the NSAF framework installed

## Installation

1. Clone this repository:
```bash
git clone https://github.com/ariunbolor/nsaf-mcp-server.git
cd nsaf-mcp-server
```

2. Install dependencies:
```bash
npm install
```

3. Build the server:
```bash
npm run build
```

## Configuration

The server includes the NSAF framework code, so no additional configuration is required for basic usage. The MCP server is designed to work out-of-the-box when installed globally.

## Usage

### Running the server locally

```bash
npm start
```

### Deploying to GitHub

1. Create a new GitHub repository for your MCP server:
   - Go to GitHub and create a new repository named `nsaf-mcp-server`
   - Initialize it with a README file

2. Use the provided setup script to push your code to GitHub:
```bash
# For a new repository
./setup-github-fixed.sh yourusername

# If the repository already exists and you want to overwrite its content
./setup-github-fixed.sh yourusername --force
```

The script will:
- Initialize git if needed
- Set up the remote repository
- Commit your changes
- Try to push to GitHub (with options to handle existing repositories)

3. Configure GitHub Actions for CI/CD (optional):
   - Create a `.github/workflows` directory
   - Add a workflow file for testing and building the server

### Using with AI Assistants

To use this MCP server with AI assistants like Claude, you need to:

1. Install the server:

   Option 1: Install from GitHub (after pushing your code):
   ```bash
   npm install -g yourusername/nsaf-mcp-server
   ```

   Option 2: Install from your local directory:
   ```bash
   # Navigate to the nsaf-mcp-server directory
   cd nsaf_mcp_server
   
   # Install dependencies and build
   npm install
   npm run build
   
   # Install globally from the local directory
   npm install -g .
   ```

2. Add the server to your MCP settings configuration:

For Claude Desktop app, edit `~/Library/Application Support/Claude/claude_desktop_config.json` (on macOS):

```json
{
  "mcpServers": {
    "nsaf": {
      "command": "nsaf-mcp-server",
      "args": [],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

For Cline, edit `/Users/onthego/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`:

```json
{
  "mcpServers": {
    "nsaf": {
      "command": "nsaf-mcp-server",
      "args": [],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

## Available Tools

### run_nsaf_evolution

Run NSAF evolution with specified parameters.

Parameters:
- `population_size`: Size of the agent population (default: 20)
- `generations`: Number of generations to evolve (default: 10)
- `mutation_rate`: Mutation rate (0.0-1.0) (default: 0.2)
- `crossover_rate`: Crossover rate (0.0-1.0) (default: 0.7)
- `architecture_complexity`: Complexity of the agent architecture ('simple', 'medium', 'complex') (default: 'medium')

### compare_nsaf_agents

Compare different NSAF agent architectures.

Parameters:
- `architectures`: List of architectures to compare (default: ['simple', 'medium', 'complex'])

## License

MIT