使用说明
aman生态系统的MCP服务器。
将身份、工具、工作流、护栏和评估作为MCP工具公开，因此任何AI代理都可以以编程方式读取和写入您的生态系统。
运作原理
┌─────────────────────────────────────────────┐
│ AI Agent / LLM │
│ (Claude, GPT, Cursor, etc.) │
└──────────────────┬──────────────────────────┘
│ MCP Protocol
┌──────────┴──────────┐
│ aman-mcp │ ← this server
│ 11 tools across │
│ 5 ecosystem layers │
└──┬──┬──┬──┬──┬─────┘
│ │ │ │ │
┌─────┘ │ │ │ └─────┐
▼ ▼ ▼ ▼ ▼
acore akit aflow arules aeval
identity tools flows guards eval
阿门 （内存）作为自己的MCP服务器运行——请参阅 阿门.
设置
Claude Code
一个衬垫：
claude mcp add aman -- npx -y @aman_asmuei/aman-mcp
或手动 添加到 ~/.claude/settings.json:
{
"mcpServers": {
"aman": {
"command": "npx",
"args": ["-y", "@aman_asmuei/aman-mcp"]
}
}
}
Cursor
添加 .cursor/mcp.json:
{
"mcpServers": {
"aman": {
"command": "npx",
"args": ["-y", "@aman_asmuei/aman-mcp"]
}
}
}
Windsurf
添加 ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"aman": {
"command": "npx",
"args": ["-y", "@aman_asmuei/aman-mcp"]
}
}
}
工具
身份（acore）-- ~/.acore/core.md
| 工具 | 说明 |
|---|---|
identity_read |
读取完整的core.md标识文件 |
identity_summary |
获取结构化摘要：AI名称、用户名、信任级别、个性 |
identity_update_session |
更新会话部分（简历、主题、决定） |
工具（景点）-- ~/.akit/kit.md
| 工具 | 说明 |
|---|---|
tools_list |
列出所有已安装的工具及其状态 |
tools_search |
按查询搜索工具注册表 |
工作流（aflow）-- ~/.aflow/flow.md
| 工具 | 说明 |
|---|---|
workflow_list |
列出所有已定义的工作流 |
workflow_get |
获取特定工作流的步骤 |
护栏（arules）-- ~/.arules/rules.md
| 工具 | 说明 |
|---|---|
rules_list |
列出所有规则类别 |
rules_check |
检查某个操作是否违反了任何规则 |
评估（aeval）-- ~/.aeval/eval.md
| 工具 | 说明 |
|---|---|
eval_status |
获取评估指标（会话、信任、轨迹） |
eval_log |
记录带有评级和注释的会话 |
项目（一个项目）-LRU工作线程跟踪器
离散的工作弧线，LRU位于10个活动插槽中，对等意图/评估/规则。活动项目在SessionStart中无条件显示。
储存： ~/.aprojects/dev/plugin/projects.md （通过MarkdownFileStorage的单个文件；匹配意图模式）。
工具：
project_add--在#1创建，转移他人，在#11驱逐project_get--读一个project_list--按状态/inActiveList筛选project_active--快速路径：位置#1project_load--模糊匹配，从列表中恢复project_touch--在列表项目中排名第一project_save--附加带时间戳的会议记录project_close--转换为完成/暂停/放弃project_update--补丁元数据；相互更新intentions.linkedProjectId
生命周期与LRU： 正交轴。 status 是生命周期（活动/暂停/完成/放弃）。 inActiveList 是LRU会员。LRU在11套公寓被驱逐 inActiveList=false 但保持 status=active --这个项目还活着，只是没有进入前十名。
双向链接： 设置 linkedIntentionId 在一个项目上也设置 linkedProjectId 根据意图（反之亦然）。关闭一侧不会关闭另一侧。
覆盖根路径： $AMAN_PROJECTS_HOME （用于测试）。
建筑
src/
├── index.ts Entry point — server setup, transport
├── tools/ MCP tool definitions per layer
├── parsers/ Markdown file parsers
└── utils/ Shared utilities
文件位置
服务器读取和写入与CLI工具相同的文件：
| 文件 | 图层 |
|---|---|
~/.acore/core.md |
身份和个性 |
~/.akit/kit.md |
工具注册表 |
~/.aflow/flow.md |
工作流定义 |
~/.arules/rules.md |
护栏规则 |
~/.aeval/eval.md |
评估日志 |
发展
git clone https://github.com/amanasmuei/aman-mcp.git
cd aman-mcp
npm install
npm run build
npm run lint
npm test
生态系统
aman
├── acore → identity → who your AI IS
├── amem → memory → what your AI KNOWS
├── akit → tools → what your AI CAN DO
├── aflow → workflows → HOW your AI works
├── arules → guardrails → what your AI WON'T do
├── aeval → evaluation → how GOOD your AI is
└── aman-mcp → MCP server → the bridge ← YOU ARE HERE
| 层 | 包 | 它的作用 |
|---|---|---|
| 身份 | 核心 | 个性、价值观、关系记忆 |
| 记忆 | 阿门 | 自动化知识存储（MCP） |
| 工具 | 吸引力 | 15个便携式人工智能工具（MCP+手动回退） |
| 工作流程 | aflow | 可重用的AI工作流程 |
| 护栏 | 阿鲁莱斯 | 安全边界和权限 |
| 评价 | 伊瓦尔 | 关系跟踪和会话日志记录 |
| 统一 | 阿曼 | 一个命令即可设置所有内容 |
贡献
欢迎投稿！打开问题或提交PR。
许可证
11个工具。5层。一台MCP服务器。
