🚀 NSAF MCP 服务器

NSAF MCP 服务器是为神经符号自主框架 (NSAF) 实现的模型上下文协议 (MCP) 服务器，它让 AI 助手能够通过 MCP 协议与 NSAF 框架进行交互，为 AI 与 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 许可证。