NSAF MCP 服务器

这是一个为神经符号自主框架 (NSAF) 实现的模型上下文协议 (MCP) 服务器。它允许 AI 助手通过 MCP 协议与 NSAF 框架交互。

注意: 此仓库包含 NSAF 框架代码和 MCP 服务器实现，使其成为一个完整的包，可以在任何地方部署和使用。

注意: 此实现使用了一个简化的 MCP 协议版本，无需官方 MCP SDK。它实现了与 NSAF 功能集成所需的最核心功能。

特性

• 使用可自定义参数运行 NSAF 进化
• 比较不同 NSAF 代理架构
• 将 NSAF 功能整合到 AI 助手中

先决条件

• Node.js 18+ 和 npm
• Python 3.8+ 带有 NSAF 框架安装

安装

1. 克隆此仓库:

git clone https://github.com/ariunbolor/nsaf-mcp-server.git
cd nsaf-mcp-server

2. 安装依赖项:

npm install

3. 构建服务器:

npm run build

配置

服务器包含 NSAF 框架代码，因此基本使用不需要额外配置。MCP 服务器设计为开箱即用。

使用方法

在本地运行服务器

npm start

部署到 GitHub

1. 创建一个新的 GitHub 仓库用于您的 MCP 服务器:

   • 访问 GitHub 并创建一个名为 nsaf-mcp-server 的新仓库
   • 初始化它并添加 README 文件

2. 使用提供的设置脚本将代码推送到 GitHub:

# 新仓库
./setup-github-fixed.sh yourusername

# 如果仓库已存在且希望覆盖内容
./setup-github-fixed.sh yourusername --force

该脚本会执行以下操作:

• 初始化 git（如果需要）
• 设置远程仓库
• 提交更改
• 尝试推送到 GitHub（带选项处理现有仓库）

3. 配置 GitHub Actions 进行 CI/CD（可选）:
   • 创建 .github/workflows 目录
   • 添加测试和构建服务器的工作流文件

与 AI 助手一起使用

要将此 MCP 服务器与 AI 助手（如Claude）一起使用，需执行以下步骤:

1. 安装服务器:

   选项 1: 从 GitHub 安装（在推送代码后）:

   npm install -g yourusername/nsaf-mcp-server
   

   选项 2: 从本地目录安装:

   # 进入 nsaf_mcp_server 目录
   cd nsaf_mcp_server
   
   # 安装依赖项并构建
   npm install
   npm run build
   
   # 从本地目录全局安装
   npm install -g .
   

2. 将服务器添加到 MCP 设置配置中:

对于 Claude Desktop 应用（macOS 上）: 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json 文件:

{
  "mcpServers": {
    "nsaf": {
      "command": "nsaf-mcp-server",
      "args": [],
      "env": {},
      "disabled": false,
      "port": null
    }
  }
}

对于其他平台，请参考相关文档。

功能

运行 NSAF 进化 (run_nsaf_evolution)

node run-nsaf-evolution.js --population-size=100 --generations=50 --mutation-rate=0.1

参数:

• --population-size: 种群大小（默认值：100）
• --generations: 进化代数（默认值：50）
• --mutation-rate: 变异率（默认值：0.1）

比较 NSAF 代理架构 (compare_nsaf_agents)

node compare-nsaf-agents.js --agent1=agent1.json --agent2=agent2.json

参数:

• --agent1: 第一个代理文件路径
• --agent2: 第二个代理文件路径

许可证

此项目采用 MIT 许可证。