aistack (Blackms)

MCPAI代理

提供方 blackms · 包名 @blackms/aistack

AI代理 stdio · 本地进程 API Key 社区 / 第三方 Claude
查看接入方式

aistack是一个用于协调多个专业AI代理共同完成复杂任务的现代多代理编排工具,支持持久化内存、对抗性验证和实时Web仪表盘,适用于代码生成、多步骤开发工作流和构建机构知识库。

一句话选型结论

按资料字段整理

aistack (Blackms) 属于AI代理类 MCP 服务器,stdio · 本地进程,API Key,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权API Key 部署方式本地部署
GitHub 星标 49 仓库热度,无公开仓库时显示未标注
工具数 41 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量41暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

多代理协作TypeScript本地部署代码生成与审查持久化内存对抗性验证开发效率工具

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
npx @blackms/aistack init

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 41 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 41 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
aistack (Blackms)当前 41 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方blackms上游标注的维护方 blackms
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时@blackms/aistack · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

26.1 KB
来自项目仓库与上游目录的原文,未做删改

Aistack

Claude代码的超现代多代理编排

生产级代理编排,具有对抗性验证、持久内存和实时web仪表板。```
11 agents · 46 MCP tools · 6 LLM providers · SQLite + FTS5 · Web dashboard · Agent Identity · Drift Detection · Consensus Checkpoints · Resource Monitoring


______________________________________________________________________

## 它的作用

aistack助您一臂之力 **协调多个专门的人工智能代理** 共同完成复杂的任务。把它想象成一个人工智能专家团队:

**你可以:**

- 产卵a **编码员** 编写代码的代理
- 产卵 **对抗的** 代理人审查并打破它
- 产卵a **测试员** 编写测试的代理
- 产卵a **文档** 代理人记录它
- 将学习内容存储在 **持久内存** 以备后用

**它是如何工作的:**

1. **Spawn专业代理商** -每个代理都有特定的专业知识(编码、测试、审查等)
1. **它们通过信息总线进行通信** -代理可以协调和共享信息
1. **内存在会话中持续存在** -代理记住模式、决策和学习
1. **对抗性验证** -通过迭代反馈自动审查和改进代码
1. **与Claude Code集成** -通过MCP协议直接从IDE使用代理

**非常适合:**

- 具有自动审查周期的代码生成
- 多步骤开发工作流程(设计→ code → test → 文件)
- 建立跨项目持续存在的机构知识
- 自动化需要不同类型专业知识的复杂任务

### 示例工作流程```
You ask: "Create a login API endpoint with tests"

aistack:
1. Spawns a Coder agent → writes the API code
2. Spawns an Adversarial agent → tries to break it, finds security issues
3. Coder fixes the issues
4. Spawns a Tester agent → writes comprehensive tests
5. Spawns a Documentation agent → generates API docs
6. Stores patterns in memory → "Always use bcrypt for passwords"

Next time: The memory helps agents make better decisions automatically

技术栈

Node.js 20+ |
TypeScript |
SQLite + FTS5 |
Vitest

React 18 |
Material-UI |
Vite |
Anthropic

OpenAI |
Ollama |
GitHub Actions |
NPM Package


✨ 特性

🤖 11种专业代理类型

每个代理都有特定的专业知识和能力:

  • 编码员 -编写、编辑和重构代码
  • 研究员 -搜索和分析代码库,收集信息
  • 测试员 -编写和运行测试、覆盖率分析
  • 审稿人 -代码审查和最佳实践
  • 对抗的 -用于查找漏洞的攻击代码(用于审查循环)
  • 建筑师 -系统设计和技术决策
  • 协调员 -为复杂任务编排多个代理
  • 分析师 -数据分析和性能分析
  • 开发运维 -部署、基础设施、监控
  • 文档 -生成和维护文档
  • 安全审计员 -安全审计、合规性、威胁建模

💾 持久存储系统

跨会话生存的知识:

  • 带FTS5的SQLite -在所有内存中快速进行全文搜索
  • 矢量嵌入 -可选语义搜索(OpenAI/Ollama)
  • 命名空间和标签 -按项目、主题或团队组织记忆
  • 版本历史 -跟踪更改并在需要时回滚
  • 记忆关系 -将相关概念联系在一起

🔄 对抗性评论循环

通过迭代反馈自动改进代码:

  1. Coder代理生成代码
  2. 对手代理评论并试图打破它
  3. Coder修复问题
  4. 重复最多3次,直至获得批准

结果:代码更健壮、更安全,错误更少。

🪪 代理身份v1

具有生命周期管理的持久代理身份:

  • 稳定的UUID -代理商具有持久性 agent_id 跨处决
  • 生命周期状态 - created → active → dormant → retired
  • 能力跟踪 -存储和版本代理功能
  • 完整审计跟踪 -每次身份更改都会被记录下来
  • 代理作用域内存 -特定代理拥有的内存命名空间

🎯 语义漂移检测

检测任务描述在语义上何时与祖先相似:

  • 基于嵌入的相似性 -使用OpenAI或Ollama嵌入
  • 可配置阈值 - threshold (阻止/警告)和 warningThreshold (仅警告)
  • 两种行为 - warn (记录并允许)或 prevent (块创建)
  • 任务关系 -轨道 parent_of, derived_from, depends_on, supersedes
  • 指标和事件 -漂移检测分析的全记录

🛡️ 资源消耗监测

检测并防止失控代理消耗过多资源:

  • 每个代理跟踪 -跟踪访问的文件、API调用、派生的子任务、消耗的令牌
  • 阶段进展 - normal → warning → intervention → termination
  • 可配置阈值 -为每种资源类型设置限制
  • 暂停/恢复控制 -自动暂停超过阈值的代理
  • 可交付检查点 -当代理产生结果时重置基于时间的跟踪
  • Slack通知 -警告、干预和终止警报

🤝 共识检查点

在高风险任务生成子任务之前需要验证:

  • 基于风险的门控 -配置哪些风险级别(高、中、低)需要达成共识
  • 审稿人策略 -从中选择 adversarial, different-model,或 human 审稿人
  • 可配置风险评估 -定义高/中风险代理类型和关键字模式
  • 任务深度跟踪 -通过以下方式防止无限任务递归 maxDepth 限制
  • 检查点生命周期 - pending → approved/rejected/expired 有审计追踪
  • 超时和自动过期 -检查点在可配置超时后过期

🎯 46个用于Claude代码的MCP工具

直接从Claude Code IDE控制堆栈:

  • 6个代理工具(生成、列表、停止、状态、类型、更新)
  • 8个身份识别工具(创建、获取、列出、更新、激活、停用、退役、审计)
  • 5个内存工具(存储、搜索、获取、列表、删除)——具有代理范围的内存支持
  • 13个任务工具(创建、分配、完成、列表、获取、check_drift、获取关系、漂流记、+5个共识工具)
  • 4个会话工具(开始、结束、状态、活动)
  • 3个系统工具(状态、运行状况、配置)
  • 7个GitHub工具(问题、PR、仓库信息)

🌐 Web仪表板

实时监控:

  • 可视化代理管理
  • 带搜索功能的内存浏览器
  • 任务队列可视化
  • 实时WebSocket更新
  • React 18+材质用户界面
  • 暗模式支持

🔌 6名法学硕士提供者

选择您喜欢的AI:

  • Anthropic -克劳德·十四行诗4(推荐)
  • 开放人工智能 -GPT-4o+嵌入
  • 奥拉玛 -本地模型(骆驼3.2)
  • ClaudeCode命令行界面 -直接集成Claude代码
  • Gemini CLI -谷歌双子座2.0
  • 法典 -GitHub Codex

🔐 安全与认证

生产就绪安全:

  • JWT身份验证
  • BCrypt密码散列
  • 基于角色的访问控制(管理员、开发人员、查看器)
  • 代码审查的安全审计员代理

📢 Slack集成

实时通知您的团队:

  • 代理事件 -生成、停止、错误
  • 工作流更新 -开始、完成、失败
  • 审查循环进度 -迭代更新
  • 资源警报 -警告、干预、终止
  • 可定制的 -选择要通知的事件

📚 文档

  • GitHub维基 -综合用户指南(54页)

  • 入门教程

  • 所有11种类型的代理指南
  • MCP工具参考
  • 实用食谱和示例
  • 高级主题(插件、自定义代理、工作流)
  • 完整的API参考

  • 技术文档 -架构和实施细节

  • API毫米 -MCP工具和程序化API

  • 建筑.md -系统架构
  • 数据.md -数据库架构
  • 安全.md -安全模型
  • ONBOARDING.md -开发者指南

🚀 快速开始

安装```bash

npm install @blackms/aistack


### 初始化并连接到Claude代码```bash
# Initialize project structure
npx @blackms/aistack init

# Add to Claude Code MCP
claude mcp add aistack -- npx @blackms/aistack mcp start

# Verify installation
npx @blackms/aistack status

启动Web仪表板```bash

Start backend + web dashboard

npx @blackms/aistack web start

Open http://localhost:3001


### 配置

创建 `aistack.config.json` 在项目根目录中:```json
{
"version": "1.5.3",
"providers": {
"default": "anthropic",
"anthropic": {
"apiKey": "${ANTHROPIC_API_KEY}",
"model": "claude-sonnet-4-20250514"
},
"openai": {
"apiKey": "${OPENAI_API_KEY}",
"model": "gpt-4o"
},
"ollama": {
"baseUrl": "http://localhost:11434",
"model": "llama3.2"
}
},
"memory": {
"path": "./data/aistack.db",
"vectorSearch": {
"enabled": false,
"provider": "openai"
}
},
"driftDetection": {
"enabled": false,
"threshold": 0.95,
"warningThreshold": 0.8,
"ancestorDepth": 3,
"behavior": "warn",
"asyncEmbedding": true
},
"resourceExhaustion": {
"enabled": false,
"thresholds": {
"maxFilesAccessed": 50,
"maxApiCalls": 100,
"maxSubtasksSpawned": 20,
"maxTimeWithoutDeliverableMs": 1800000,
"maxTokensConsumed": 500000
},
"warningThresholdPercent": 0.7,
"checkIntervalMs": 10000,
"autoTerminate": false,
"requireConfirmationOnIntervention": true,
"pauseOnIntervention": true
},
"slack": {
"enabled": false,
"webhookUrl": "${SLACK_WEBHOOK_URL}",
"channel": "#aistack-notifications",
"notifyOnAgentSpawn": false,
"notifyOnWorkflowComplete": true,
"notifyOnErrors": true,
"notifyOnReviewLoop": true,
"notifyOnResourceWarning": true,
"notifyOnResourceIntervention": true
},
"consensus": {
"enabled": false,
"requireForRiskLevels": ["high", "medium"],
"reviewerStrategy": "adversarial",
"timeout": 300000,
"maxDepth": 5,
"autoReject": false,
"highRiskAgentTypes": ["coder", "devops", "security-auditor"],
"mediumRiskAgentTypes": ["architect", "coordinator", "analyst"],
"highRiskPatterns": ["delete", "remove", "drop", "deploy", "production", "credentials", "secret", "password", "token", "api key"],
"mediumRiskPatterns": ["modify", "update", "change", "configure", "install"]
}
}

💡 用法示例

示例1:代码生成与审查

通过克劳德代码(MCP):```
In Claude Code, just ask:
"Use aistack to generate a REST API for user authentication with adversarial review"

aistack will:
1. Spawn a coder agent to write the API
2. Spawn an adversarial agent to find vulnerabilities
3. Fix issues iteratively (up to 3 rounds)
4. Return production-ready code


**通过CLI**:```bash
# Start adversarial review loop
npx @blackms/aistack workflow run adversarial-review \
--task "Create REST API for user authentication"

# Check the review status
npx @blackms/aistack agent list

通过TypeScript:```typescript
import { createReviewLoop, getConfig } from '@blackms/aistack';

const result = await createReviewLoop(
'Create REST API for user authentication',
getConfig(),
{ maxIterations: 3 }
);

console.log(result.finalVerdict); // APPROVED
console.log(result.currentCode); // Production-ready code


### 示例2:建立机构知识

**学习时存储模式**:```bash
# Store a coding pattern
npx @blackms/aistack memory store \
-k "api:error-handling" \
-c "Always return { success: boolean, data?, error? } structure" \
-n "best-practices"

# Store an architecture decision
npx @blackms/aistack memory store \
-k "db:connection" \
-c "Use connection pooling with max 10 connections" \
-n "architecture"

需要时搜索:```bash

Find all patterns about error handling

npx @blackms/aistack memory search -q "error handling" -n "best-practices"

Find architecture decisions about databases

npx @blackms/aistack memory search -q "database" -n "architecture"


**克劳德密码**:```
You: "What's our pattern for API error handling?"
Claude uses memory_search tool: Returns your stored pattern
Claude: "Based on your team's pattern, use { success, data, error } structure"

示例3:多代理协作

使用测试和文档生成功能:```typescript
import { spawnAgent, getMemoryManager, getConfig } from '@blackms/aistack';

// 1. Coder writes the feature
const coder = spawnAgent('coder', { name: 'feature-coder' });
const code = await executeTask(coder, 'Create user profile API');

// 2. Tester writes tests
const tester = spawnAgent('tester', { name: 'test-writer' });
const tests = await executeTask(tester, 'Write tests for user profile API');

// 3. Documentation agent generates docs
const docs = spawnAgent('documentation', { name: 'doc-writer' });
const documentation = await executeTask(docs, 'Document user profile API');

// 4. Store the pattern for future use
const memory = getMemoryManager(getConfig());
await memory.store('pattern:user-api', 'User API pattern with tests and docs', {
namespace: 'patterns',
metadata: { code, tests, documentation }
});


### 示例4:在Claude代码中使用

安装MCP服务器后:```bash
claude mcp add aistack -- npx @blackms/aistack mcp start

在Claude Code中,您可以:```
"Spawn a researcher agent to analyze this codebase"
→ Uses agent_spawn tool

"Store this pattern in memory: Always validate user input"
→ Uses memory_store tool

"Search memory for authentication patterns"
→ Uses memory_search tool

"Start an adversarial review of this function"
→ Uses review_loop_start tool

"List all active agents"
→ Uses agent_list tool


### 示例5:CLI工作流```bash
# 1. Start a session
npx @blackms/aistack session start --metadata '{"project": "myapp"}'

# 2. Spawn specialized agents
npx @blackms/aistack agent spawn -t coder -n backend-coder
npx @blackms/aistack agent spawn -t tester -n test-writer
npx @blackms/aistack agent spawn -t reviewer -n code-reviewer

# 3. Run tasks (agents process automatically)
npx @blackms/aistack agent run -t coder -p "Create login endpoint"
npx @blackms/aistack agent run -t tester -p "Test login endpoint"
npx @blackms/aistack agent run -t reviewer -p "Review login code"

# 4. Check system status
npx @blackms/aistack status

# 5. End session
npx @blackms/aistack session end

示例6:Web仪表板```bash

Start the dashboard

npx @blackms/aistack web start


然后打开http://localhost:3001致:

- 👀 **监视器** 所有活性剂实时
- 🧠 **浏览** 并搜索您的内存数据库
- ✅ **管理** 可视化任务和工作流
- 📊 **视图** 系统健康和统计
- 🔄 **手表** 对抗性审查循环正在进行中

______________________________________________________________________

## 📦 MCP工具

### 代理工具(6)

|工具|描述|输入|代码|
|------|-------------|-------|------|
| `agent_spawn` |生成一个新代理| `{ type, name?, sessionId?, metadata? }` | `/src/mcp/tools/agent-tools.ts:45` |
| `agent_list` |列出活动代理| `{ sessionId? }` | `/src/mcp/tools/agent-tools.ts:90` |
| `agent_stop` |阻止代理人| `{ id?, name? }` | `/src/mcp/tools/agent-tools.ts:117` |
| `agent_status` |获取代理状态| `{ id?, name? }` | `/src/mcp/tools/agent-tools.ts:144` |
| `agent_types` |列出可用的代理类型| `{}` | `/src/mcp/tools/agent-tools.ts:188` |
| `agent_update_status` |更新代理状态| `{ id, status }` | `/src/mcp/tools/agent-tools.ts:214` |

### 记忆工具(5)

|工具|描述|输入|代码|
|------|-------------|-------|------|
| `memory_store` |存储内存条目| `{ key, content, namespace?, metadata?, agentId? }` | `/src/mcp/tools/memory-tools.ts:48` |
| `memory_search` |使用FTS5搜索| `{ query, namespace?, limit?, agentId?, includeShared? }` | `/src/mcp/tools/memory-tools.ts:94` |
| `memory_get` |按键获取| `{ key, namespace? }` | `/src/mcp/tools/memory-tools.ts:145` |
| `memory_list` |列出所有条目| `{ namespace?, limit?, offset?, agentId?, includeShared? }` | `/src/mcp/tools/memory-tools.ts:182` |
| `memory_delete` |删除条目| `{ key, namespace? }` | `/src/mcp/tools/memory-tools.ts:221` |

### 身份识别工具(8)

|工具|描述|输入|代码|
|------|-------------|-------|------|
| `identity_create` |创建代理身份| `{ agentType, displayName?, capabilities?, metadata? }` | `/src/mcp/tools/identity-tools.ts:98` |
| `identity_get` |通过ID或姓名获取身份| `{ agentId?, displayName? }` | `/src/mcp/tools/identity-tools.ts:155` |
| `identity_list` |列出身份| `{ status?, agentType?, limit?, offset? }` | `/src/mcp/tools/identity-tools.ts:205` |
| `identity_update` |更新身份元数据| `{ agentId, displayName?, metadata?, capabilities? }` | `/src/mcp/tools/identity-tools.ts:247` |
| `identity_activate` |激活身份| `{ agentId, actorId? }` | `/src/mcp/tools/identity-tools.ts:311` |
| `identity_deactivate` |停用身份| `{ agentId, reason?, actorId? }` | `/src/mcp/tools/identity-tools.ts:342` |
| `identity_retire` |退休身份(永久)| `{ agentId, reason?, actorId? }` | `/src/mcp/tools/identity-tools.ts:378` |
| `identity_audit` |获取审计跟踪| `{ agentId, limit? }` | `/src/mcp/tools/identity-tools.ts:414` |

### 任务工具(8)

|工具|描述|输入|代码|
|------|-------------|-------|------|
| `task_create` |创建带有漂移检测的任务| `{ agentType, input?, sessionId?, parentTaskId?, riskLevel? }` | `/src/mcp/tools/task-tools.ts:50` |
| `task_assign` |将任务分配给代理| `{ taskId, agentId }` | `/src/mcp/tools/task-tools.ts:138` |
| `task_complete` |标记任务完成| `{ taskId, output?, status? }` | `/src/mcp/tools/task-tools.ts:169` |
| `task_list` |列出任务| `{ sessionId?, status? }` | `/src/mcp/tools/task-tools.ts:206` |
| `task_get` |获取任务详细信息| `{ taskId }` | `/src/mcp/tools/task-tools.ts:236` |
| `task_check_drift` |检查语义漂移| `{ taskInput, taskType, parentTaskId? }` | `/src/mcp/tools/task-tools.ts:273` |
| `task_get_relationships` |获取任务关系| `{ taskId, direction? }` | `/src/mcp/tools/task-tools.ts:328` |
| `task_drift_metrics` |获取漂移检测指标| `{ since? }` | `/src/mcp/tools/task-tools.ts:376` |

### 共识工具(5)

|工具|描述|输入|代码|
|------|-------------|-------|------|
| `consensus_check` |检查是否需要达成共识| `{ agentType, input?, parentTaskId?, riskLevel? }` | `/src/mcp/tools/task-tools.ts:504` |
| `consensus_list_pending` |列出待处理的检查点| `{ limit?, offset? }` | `/src/mcp/tools/task-tools.ts:560` |
| `consensus_get` |获取检查点详细信息| `{ checkpointId }` | `/src/mcp/tools/task-tools.ts:610` |
| `consensus_approve` |批准检查点| `{ checkpointId, reviewedBy, feedback? }` | `/src/mcp/tools/task-tools.ts:670` |
| `consensus_reject` |拒绝检查点| `{ checkpointId, reviewedBy, feedback?, rejectedSubtaskIds? }` | `/src/mcp/tools/task-tools.ts:720` |

### 会话工具(4)

|工具|描述|输入|代码|
|------|-------------|-------|------|
| `session_start` |开始新会话| `{ metadata? }` | `/src/mcp/tools/session-tools.ts:23` |
| `session_end` |结束会话| `{ sessionId }` | `/src/mcp/tools/session-tools.ts:56` |
| `session_status` |获取会话状态| `{ sessionId }` | `/src/mcp/tools/session-tools.ts:85` |
| `session_active` |列出活动会话| `{}` | `/src/mcp/tools/session-tools.ts:138` |

### 系统工具(3)

|工具|描述|输入|代码|
|------|-------------|-------|------|
| `system_status` |获取系统状态| `{}` | `/src/mcp/tools/system-tools.ts:12` |
| `system_health` |健康检查| `{}` | `/src/mcp/tools/system-tools.ts:52` |
| `system_config` |获取配置| `{}` | `/src/mcp/tools/system-tools.ts:131` |

### GitHub工具(7)

|工具|描述|输入|代码|
|------|-------------|-------|------|
| `github_issue_create` |创建问题| `{ owner, repo, title, body }` | `/src/mcp/tools/github-tools.ts:94` |
| `github_issue_list` |列出问题| `{ owner, repo, state? }` | `/src/mcp/tools/github-tools.ts:137` |
| `github_issue_get` |获取问题| `{ owner, repo, number }` | `/src/mcp/tools/github-tools.ts:170` |
| `github_pr_create` |创建PR| `{ owner, repo, title, body, head, base }` | `/src/mcp/tools/github-tools.ts:198` |
| `github_pr_list` |列出PR| `{ owner, repo, state? }` | `/src/mcp/tools/github-tools.ts:240` |
| `github_pr_get` |获取PR| `{ owner, repo, number }` | `/src/mcp/tools/github-tools.ts:273` |
| `github_repo_info` |获取回购信息| `{ owner, repo }` | `/src/mcp/tools/github-tools.ts:301` |

**总计:46个MCP工具**

> **注:** 评审循环功能可通过程序化API获得(`createReviewLoop`)但不作为MCP工具公开。

______________________________________________________________________

## 💻 程序化API

### TypeScript SDK```typescript
import {
spawnAgent,
getMemoryManager,
startMCPServer,
getConfig,
createReviewLoop,
} from '@blackms/aistack';

// Spawn an agent
const agent = spawnAgent('coder', {
name: 'my-coder',
metadata: { project: 'awesome-app' }
});

// Use memory with FTS5 search
const memory = getMemoryManager(getConfig());
await memory.store('architecture:pattern', 'Use dependency injection', {
namespace: 'best-practices',
tags: ['architecture', 'patterns'],
});

const results = await memory.search('dependency injection');
console.log(results); // FTS5 ranked results

// Start adversarial review loop
const reviewState = await createReviewLoop(
'Write a secure authentication function',
getConfig(),
{ maxIterations: 3 }
);

console.log(reviewState.finalVerdict); // APPROVED or REJECTED
console.log(reviewState.currentCode);
console.log(reviewState.reviews); // All review rounds

// Start MCP server
const server = await startMCPServer(getConfig());
console.log('MCP server listening on stdio');

子模块导入```typescript

import { MemoryManager } from '@blackms/aistack/memory';
import { spawnAgent, listAgentTypes, pauseAgent, resumeAgent } from '@blackms/aistack/agents';
import { startMCPServer } from '@blackms/aistack/mcp';
import { getResourceExhaustionService } from '@blackms/aistack/monitoring';

// Direct imports for smaller bundles
const agentTypes = listAgentTypes();
// => ['coder', 'researcher', 'tester', 'reviewer', 'adversarial', 'architect', 'coordinator', 'analyst', 'devops', 'documentation', 'security-auditor']


______________________________________________________________________

## 📂 项目结构```
aistack/
├── src/
│   ├── agents/          # 11 agent types with system prompts + identity service
│   ├── mcp/             # MCP server + 41 tools
│   ├── memory/          # SQLite + FTS5 + vector search
│   ├── tasks/           # Drift detection service
│   ├── monitoring/      # Resource exhaustion, metrics, health
│   ├── coordination/    # Task queue, message bus, review loop
│   ├── web/             # REST API + WebSocket server + identity routes
│   ├── providers/       # 6 LLM provider integrations
│   ├── workflows/       # Multi-phase workflow engine
│   ├── auth/            # JWT + RBAC authentication
│   ├── github/          # GitHub issues/PRs integration
│   ├── plugins/         # Plugin system
│   ├── hooks/           # Lifecycle hooks
│   └── cli/             # Command-line interface
│
├── web/                 # React 18 dashboard
│   └── src/
│       ├── pages/       # 11 dashboard pages
│       ├── components/  # React components
│       └── stores/      # Zustand state management
│
├── migrations/          # Database migrations
├── tests/               # Unit + integration tests
├── docs/                # Technical documentation
└── .github/workflows/   # CI/CD pipeline

🧪 开发与测试

构建与测试```bash

npm install # Install dependencies
npm run build # Build TypeScript to dist/
npm test # Run all tests (unit + integration)
npm run test:unit # Unit tests only
npm run test:integration # Integration tests only
npm run test:coverage # Generate coverage report
npm run typecheck # Type check without emit
npm run lint # ESLint


### CI/CD管道

GitHub操作工作流 **5个并行作业**:

1. **棉绒** -ESLint代码质量检查
1. **类型检查** -TypeScript类型验证
1. **单元测试** -快速隔离测试
1. **集成测试** -数据库+代理集成
1. **构建** -生产构建验证

**代码覆盖范围:** 测试完成后上传到Codecov

**代码:** `.github/workflows/ci.yml`

### Web仪表板开发```bash
npm run dev:web           # Start Vite dev server (hot reload)
npm run build:web         # Build for production

⚠️ aistack不包括什么

为了设定准确的期望,以下是功能 明确未实施:

  • ❌ Docker容器化 (没有 Dockerfile 在项目根中)
  • ❌ Kubernetes/Helm清单 (无编排配置)
  • ❌ 云特定部署 (AWS、GCP、Azure模板)
  • ❌ GraphQL API (仅限REST+WebSocket)
  • ❌ 多租户技术 (每次部署一个SQLite实例)
  • ⚠️ 可观察性有限 -内置健康检查和Prometheus风格的指标,但没有Grafana仪表板
  • ❌ 消息队列系统 (没有Kafka、RabbitMQ、Redis流)
  • ❌ 分布式跟踪 (无OpenTetry集成)

aistack被设计为 本地优先,NPM分布式包 适用于开发人员工作流,而不是云原生微服务。


🗺️ 路线图

aistack的主要用例是功能完整的:本地Claude代码与多代理编排的集成。

当前重点领域:

  • 稳定性和错误修复
  • 文档改进
  • 社区要求的功能

🤝 贡献

  1. 克隆该仓库
  2. 创建要素分支(git checkout -b feature/amazing)
  3. 提交更改(git commit -m 'Add amazing feature')
  4. 推送到分支(git push origin feature/amazing)
  5. 打开拉取请求

PR要求:

  • 所有测试均通过(npm test)
  • 代码过梁(npm run lint)
  • 类型已检查(npm run typecheck)
  • 构建成功(npm run build)
  • 保持或改进代码覆盖率

📄 许可证

麻省理工学院 © 2024


维基 · 文档 · 问题 · 讨论 · NPM包

基于TypeScript构建·专为克劳德代码打造·通过NPM分发


✅ README已根据代码库v1.5.3进行验证 -所有声明均由具有file:行引用的已实现代码支持(包括共识检查点、资源耗尽监控和基于会话的内存隔离)

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
aistack (Blackms) 怎么安装?

在客户端按下面的安装命令接入:npx @blackms/aistack init。对应的包名是 @blackms/aistack。装完在客户端配置里引用同一个包或端点。

aistack (Blackms) 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

aistack (Blackms) 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

aistack (Blackms) 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

aistack (Blackms) 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

aistack (Blackms) 能提供哪些能力?

资料显示约 41 个工具;能力标签包括 多代理协作、TypeScript、Claude。具体工具清单以官方文档为准。

aistack (Blackms) 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

aistack (Blackms) 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。