pasm-mcp-server 0.2.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- pasm_mcp_server-0.2.0/CHANGELOG.md +91 -0
- pasm_mcp_server-0.2.0/LICENSE +21 -0
- pasm_mcp_server-0.2.0/MANIFEST.in +6 -0
- pasm_mcp_server-0.2.0/PKG-INFO +235 -0
- pasm_mcp_server-0.2.0/README.md +203 -0
- pasm_mcp_server-0.2.0/examples/mcp_claude_desktop.json +12 -0
- pasm_mcp_server-0.2.0/examples/mcp_cursor.json +13 -0
- pasm_mcp_server-0.2.0/examples/mcp_generic.json +17 -0
- pasm_mcp_server-0.2.0/examples/mcp_vscode.json +14 -0
- pasm_mcp_server-0.2.0/pasm_mcp_server/__init__.py +26 -0
- pasm_mcp_server-0.2.0/pasm_mcp_server/__main__.py +11 -0
- pasm_mcp_server-0.2.0/pasm_mcp_server/bridge.py +160 -0
- pasm_mcp_server-0.2.0/pasm_mcp_server/protocol.py +75 -0
- pasm_mcp_server-0.2.0/pasm_mcp_server/py.typed +0 -0
- pasm_mcp_server-0.2.0/pasm_mcp_server/server.py +268 -0
- pasm_mcp_server-0.2.0/pasm_mcp_server/tools.py +647 -0
- pasm_mcp_server-0.2.0/pasm_mcp_server.egg-info/PKG-INFO +235 -0
- pasm_mcp_server-0.2.0/pasm_mcp_server.egg-info/SOURCES.txt +22 -0
- pasm_mcp_server-0.2.0/pasm_mcp_server.egg-info/dependency_links.txt +1 -0
- pasm_mcp_server-0.2.0/pasm_mcp_server.egg-info/entry_points.txt +2 -0
- pasm_mcp_server-0.2.0/pasm_mcp_server.egg-info/requires.txt +7 -0
- pasm_mcp_server-0.2.0/pasm_mcp_server.egg-info/top_level.txt +1 -0
- pasm_mcp_server-0.2.0/pyproject.toml +56 -0
- pasm_mcp_server-0.2.0/setup.cfg +4 -0
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
本项目遵循[语义化版本](https://semver.org/lang/zh-CN/)。
|
|
4
|
+
|
|
5
|
+
## [0.2.0] — 2026-09-15
|
|
6
|
+
|
|
7
|
+
**通用化 + 认知能力接入**:从"能挂进某一个客户端"升级为"任何 MCP 客户端都能挂",
|
|
8
|
+
并把基座 0.5.0 的认知能力层接进来。
|
|
9
|
+
|
|
10
|
+
### 新增
|
|
11
|
+
|
|
12
|
+
- **3 个新工具**(共 13 个)
|
|
13
|
+
- `pasm_semantic` 语义检索 + 可解释打分(融合分 / 语义分 / 记忆保留度 / 被唤起次数),
|
|
14
|
+
并回显查询被扩展成了哪些同义说法
|
|
15
|
+
- `pasm_focus` 焦点栈:压入/查看"现在在聊什么",给后续检索加权
|
|
16
|
+
- `pasm_consolidate` 记忆巩固(睡眠回放),默认只出建议,`apply=true` 才执行
|
|
17
|
+
- **认知能力自动接入**:依赖 `pasm-skills>=0.5.0` 时,`pasm_recall` / `pasm_context` /
|
|
18
|
+
`pasm_observe` 自动走认知中枢(语义检索 + 遗忘加权 + 焦点 + 同步索引),
|
|
19
|
+
并在 `pasm_status` 里如实报告当前向量后端。**装不上也不报错**,退回字面匹配
|
|
20
|
+
- **主流客户端配置示例**:Cursor / Claude Desktop / VS Code(Copilot) / 通用 stdio
|
|
21
|
+
- `MANIFEST.in`,`dist` 打包就绪(`python -m build`)
|
|
22
|
+
|
|
23
|
+
### 修复
|
|
24
|
+
|
|
25
|
+
- **打包元数据版本号错误**:`pyproject.toml` 的 `version` 还是 `0.1.0`,而代码、README、
|
|
26
|
+
CHANGELOG 都已是 `0.2.0` —— 真打包出来会得到 `pasm_mcp_server-0.1.0-py3-none-any.whl`,
|
|
27
|
+
发到 PyPI 就是"用 0.1.0 的名义发布 0.2.0 的内容",且与 `__version__` 自相矛盾。
|
|
28
|
+
已对齐为 `0.2.0`。
|
|
29
|
+
- **`pyproject` 的 `description` 残留特定产品名**(此前清理漏了这一处,而它会被写进
|
|
30
|
+
PyPI 元数据公开可见)→ 改为通用表述"任意支持 MCP 的客户端"。
|
|
31
|
+
|
|
32
|
+
### 变更
|
|
33
|
+
|
|
34
|
+
- `pasm_status` 增加 `cognition` 段:向量后端名、索引条数、焦点、归档、记忆强度分布
|
|
35
|
+
- `pasm_context` 增加 `cognition`(当前检索模式)与 `focus`(焦点提示词)字段
|
|
36
|
+
- 依赖提升到 `pasm-skills>=0.5.0`;新增可选依赖组 `embed`(本地语义向量)
|
|
37
|
+
- 文档与示例去掉对特定产品的依赖,改为通用接入说明
|
|
38
|
+
- 日志可静默:宿主客户端若把 stderr 也收进自身日志,设 `PASM_MCP_QUIET=1` 即可
|
|
39
|
+
(工具失败信息仍通过 `isError` 内容回给模型,不影响纠错)
|
|
40
|
+
- 补齐六仓同频的生态索引(此前五仓都有、本仓漏了)
|
|
41
|
+
- README 自检项数由「10 项」更正为实际的「16 项」(新增 3 个工具后已不止 10)
|
|
42
|
+
|
|
43
|
+
### 验证
|
|
44
|
+
|
|
45
|
+
- `pasm-mcp-server --selftest`:通过(16 项)
|
|
46
|
+
- `python examples/stdio_client_demo.py`:端到端通过
|
|
47
|
+
|
|
48
|
+
## [0.1.0] — 2026-09-15
|
|
49
|
+
|
|
50
|
+
首个版本:**把 PASM 认知内核以 MCP 标准协议暴露出去**。
|
|
51
|
+
|
|
52
|
+
这是 PASM 生态「分发层」的落地 —— 不改任何外部产品一行代码,
|
|
53
|
+
就能让支持 MCP 的 Agent(桌面 AI 客户端 / IDE 插件 / 自研)用上
|
|
54
|
+
PASM 的长期记忆、情绪状态与行为倾向。
|
|
55
|
+
|
|
56
|
+
### 新增
|
|
57
|
+
|
|
58
|
+
- **stdio MCP 服务器**(`pasm_mcp_server.server`)
|
|
59
|
+
- 纯标准库实现,不依赖官方 MCP SDK,冷启动快
|
|
60
|
+
- 支持 `initialize`(版本协商)、`ping`、`tools/list`、`tools/call`、
|
|
61
|
+
`notifications/*`、`shutdown`
|
|
62
|
+
- 协议版本协商:客户端版本在支持列表内则回显,否则回默认版本
|
|
63
|
+
- 版本支持:`2024-11-05` / `2025-03-26` / `2025-06-18` / `2026-07-28`
|
|
64
|
+
- **10 个 MCP 工具**(`pasm_mcp_server.tools`)
|
|
65
|
+
- `pasm_context` 认知上下文(接进提示词的主入口,只读)
|
|
66
|
+
- `pasm_recall` / `pasm_observe` 记忆检索与写入
|
|
67
|
+
- `pasm_feel` 情绪输入
|
|
68
|
+
- `pasm_act` / `pasm_feedback` 动作选择与反馈塑形
|
|
69
|
+
- `pasm_chat` 完整认知回路
|
|
70
|
+
- `pasm_persona` / `pasm_status` / `pasm_save` 人格与运维
|
|
71
|
+
- **PASM 认知桥**(`pasm_mcp_server.bridge`)
|
|
72
|
+
- 按 `agent_id` 管理 `BaseAgent` 实例,同 id 跨调用共享认知状态
|
|
73
|
+
- 多智能体隔离,各自落盘到 `~/.pasm-mcp/<agent_id>/`
|
|
74
|
+
- 档位透明:`light` / `core` / `bionic` 如实标注,不隐藏降级
|
|
75
|
+
- **工具与示例**
|
|
76
|
+
- `pasm-mcp-server --selftest` 本地自检(10 项)
|
|
77
|
+
- `examples/stdio_client_demo.py` 模拟客户端的端到端冒烟测试
|
|
78
|
+
- `examples/mcp_generic.json` 通用 stdio 客户端配置
|
|
79
|
+
- `examples/mcp_cursor.json` / `mcp_claude_desktop.json` / `mcp_vscode.json`
|
|
80
|
+
|
|
81
|
+
### 设计决定
|
|
82
|
+
|
|
83
|
+
- 依赖**公开的** `pasm-skills>=0.4.4`,不依赖私有 PASM 核心:
|
|
84
|
+
没装核心跑 `light` 档,装了自动升级。
|
|
85
|
+
- 不内置 LLM:回复走模板渲染。语言生成交给客户端自己的模型,
|
|
86
|
+
PASM 只负责记忆 / 情绪 / 倾向。
|
|
87
|
+
|
|
88
|
+
### 验证
|
|
89
|
+
|
|
90
|
+
- `pasm-mcp-server --selftest`:10/10 通过
|
|
91
|
+
- `python examples/stdio_client_demo.py`:10/10 通过(本机 tier=light)
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 arronzheng
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,235 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: pasm-mcp-server
|
|
3
|
+
Version: 0.2.0
|
|
4
|
+
Summary: PASM 认知内核的 MCP 服务器 —— 把 PASM 的记忆/情绪/动作/反馈能力暴露成标准 MCP 工具,挂进任意支持 MCP 的客户端(Claude Desktop / Cursor / VS Code / 自研 Agent)
|
|
5
|
+
Author: arronzheng
|
|
6
|
+
License: MIT
|
|
7
|
+
Project-URL: Homepage, https://gitee.com/arronzheng/pasm-mcp-server
|
|
8
|
+
Project-URL: Repository, https://github.com/arronJack/pasm-mcp-server
|
|
9
|
+
Project-URL: Source, https://gitee.com/arronzheng/pasm-mcp-server
|
|
10
|
+
Project-URL: Issues, https://gitee.com/arronzheng/pasm-mcp-server/issues
|
|
11
|
+
Keywords: pasm,mcp,model-context-protocol,agent,cognition,memory,emotion,cognitive-architecture,tool-server
|
|
12
|
+
Classifier: Development Status :: 4 - Beta
|
|
13
|
+
Classifier: Intended Audience :: Developers
|
|
14
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
15
|
+
Classifier: Operating System :: OS Independent
|
|
16
|
+
Classifier: Programming Language :: Python :: 3
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
20
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
21
|
+
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
|
|
22
|
+
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
23
|
+
Requires-Python: >=3.10
|
|
24
|
+
Description-Content-Type: text/markdown
|
|
25
|
+
License-File: LICENSE
|
|
26
|
+
Requires-Dist: pasm-skills>=0.5.0
|
|
27
|
+
Provides-Extra: torch
|
|
28
|
+
Requires-Dist: torch; extra == "torch"
|
|
29
|
+
Provides-Extra: embed
|
|
30
|
+
Requires-Dist: fastembed; extra == "embed"
|
|
31
|
+
Dynamic: license-file
|
|
32
|
+
|
|
33
|
+
# PASM MCP Server · 给任意 AI 客户端装上长期记忆
|
|
34
|
+
|
|
35
|
+
> **把 PASM 的认知内核暴露成标准 MCP 工具。**
|
|
36
|
+
> 你的大模型(IDE 插件 / 桌面 AI 客户端 / 自研 Agent)本身没有跨会话记忆、没有情绪连续性、
|
|
37
|
+
> 没有"被夸过就更爱做某件事"的行为倾向 —— 这个包就是给它补上这些。
|
|
38
|
+
|
|
39
|
+
**一句话定位**:PASM 不是"又一个聊天模型",是一个**认知器官** ——
|
|
40
|
+
记忆、情绪、行为倾向。语言生成仍然由你自己的模型负责。
|
|
41
|
+
|
|
42
|
+
```
|
|
43
|
+
┌──────────────────────────┐ MCP (stdio) ┌──────────────────────┐
|
|
44
|
+
│ 你的 AI 客户端 / Agent │ ◄─────────────► │ pasm-mcp-server │
|
|
45
|
+
│ (负责说话与推理) │ 工具调用 │ (负责记住与感受) │
|
|
46
|
+
└──────────────────────────┘ └──────────────────────┘
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## 〇、PASM 生态索引(六仓同频)
|
|
52
|
+
|
|
53
|
+
| 仓 | 角色 | 可见性 | 版本 |
|
|
54
|
+
|---|---|---|---|
|
|
55
|
+
| `pasm-skills` | 基座:`BaseAgent` + 认知能力层 | 公开 | 0.5.0 |
|
|
56
|
+
| `pasm-agents` | 成品智能体集(NPC / 陪伴 / 教学 / 验证) | 公开 | 0.4.5 |
|
|
57
|
+
| **`pasm-mcp-server`(本仓)** | **MCP 接入层:给任意 AI 客户端装长期记忆** | 公开 | **0.2.0** |
|
|
58
|
+
| `PASM-Lite` | 教学版 + 认知引擎接口 | 公开 | — |
|
|
59
|
+
| `PASM` | 核心引擎(七层仿生 / 世界模型) | **私有** | 0.7.2 |
|
|
60
|
+
| `pasm-qclaw` | 桌面应用发行通道 | 公开 | 0.29.1 |
|
|
61
|
+
|
|
62
|
+
流向:`PASM`(核心)→ `pasm-skills`(基座)→ `pasm-agents`(智能体)→
|
|
63
|
+
`pasm-mcp-server`(分发)→ `pasm-qclaw`(桌面产品);`PASM-Lite` 是面向外界的教学窗口。
|
|
64
|
+
|
|
65
|
+
地址:
|
|
66
|
+
[Gitee](https://gitee.com/arronzheng/pasm-mcp-server) ·
|
|
67
|
+
[GitHub](https://github.com/arronJack/pasm-mcp-server)
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## 一、快速开始
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
pip install pasm-mcp-server
|
|
75
|
+
pasm-mcp-server --selftest # 自检(16 项)
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
### 接入客户端(以 Cursor 为例)
|
|
79
|
+
|
|
80
|
+
写到 `.cursor/mcp.json`(项目级)或 `~/.cursor/mcp.json`(全局):
|
|
81
|
+
|
|
82
|
+
```json
|
|
83
|
+
{
|
|
84
|
+
"mcpServers": {
|
|
85
|
+
"pasm": {
|
|
86
|
+
"command": "python",
|
|
87
|
+
"args": ["-m", "pasm_mcp_server"]
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
> Windows 上如果 `python` 不在 PATH,把它换成绝对路径,例如 `"C:\\Python313\\python.exe"`。
|
|
94
|
+
|
|
95
|
+
### 各客户端配置位置
|
|
96
|
+
|
|
97
|
+
| 客户端 | 配置文件 | 字段形状 |
|
|
98
|
+
|---|---|---|
|
|
99
|
+
| **Cursor** | `.cursor/mcp.json` 或 `~/.cursor/mcp.json` | `mcpServers` |
|
|
100
|
+
| **Claude Desktop** | `%APPDATA%\Claude\claude_desktop_config.json`(macOS:`~/Library/Application Support/Claude/`) | `mcpServers` |
|
|
101
|
+
| **VS Code**(Copilot Agent) | `.vscode/mcp.json` | `servers` + `"type": "stdio"` |
|
|
102
|
+
| **自建 / 其他客户端** | 见 `examples/mcp_generic.json` | `mcpServers` |
|
|
103
|
+
|
|
104
|
+
现成文件:[`examples/mcp_cursor.json`](examples/mcp_cursor.json) ·
|
|
105
|
+
[`examples/mcp_claude_desktop.json`](examples/mcp_claude_desktop.json) ·
|
|
106
|
+
[`examples/mcp_vscode.json`](examples/mcp_vscode.json) ·
|
|
107
|
+
[`examples/mcp_generic.json`](examples/mcp_generic.json)
|
|
108
|
+
|
|
109
|
+
**校验是否接上**:`python examples/stdio_client_demo.py` —— 它会真的起一个子进程、
|
|
110
|
+
做完整握手、逐个调用工具(和真实客户端做的事一模一样)。
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
## 二、工具有哪些(13 个)
|
|
115
|
+
|
|
116
|
+
### 认知核心
|
|
117
|
+
|
|
118
|
+
| 工具 | 干什么 |
|
|
119
|
+
|---|---|
|
|
120
|
+
| **`pasm_context`** ⭐ | **首选**。取"现在该记得什么 + 情绪如何 + 倾向做什么",拿去拼进提示词。只读,不写记忆 |
|
|
121
|
+
| `pasm_recall` | 记忆检索(装了认知层自动走语义) |
|
|
122
|
+
| `pasm_semantic` | 语义检索 + 可解释:换说法也能命中,并给出每条的融合分 / 语义分 / 记忆保留度 |
|
|
123
|
+
| `pasm_observe` | 把一件事写进长期记忆(重要度 1-5) |
|
|
124
|
+
| `pasm_feel` | 报告带情绪效价的事件,驱动情绪演化 |
|
|
125
|
+
| `pasm_act` | 按「人格 + 学到的偏好」选一个动作 |
|
|
126
|
+
| `pasm_feedback` | 反馈塑形(**务必带 `action`**) |
|
|
127
|
+
|
|
128
|
+
### 记忆维护
|
|
129
|
+
|
|
130
|
+
| 工具 | 干什么 |
|
|
131
|
+
|---|---|
|
|
132
|
+
| `pasm_focus` | 焦点栈:压入/查看"现在在聊什么",给检索加权 |
|
|
133
|
+
| `pasm_consolidate` | 记忆巩固(睡眠回放):把重复经历蒸馏成要点。默认只出建议 |
|
|
134
|
+
|
|
135
|
+
### 管理
|
|
136
|
+
|
|
137
|
+
| 工具 | 干什么 |
|
|
138
|
+
|---|---|
|
|
139
|
+
| `pasm_chat` | 完整认知回路对话一次(模板渲染,非 LLM) |
|
|
140
|
+
| `pasm_persona` | 查看/合并更新人格 |
|
|
141
|
+
| `pasm_status` | 状态快照(档位、记忆量、认知层后端、焦点、归档) |
|
|
142
|
+
| `pasm_save` | 立即落盘 |
|
|
143
|
+
|
|
144
|
+
---
|
|
145
|
+
|
|
146
|
+
## 三、认知能力(0.2.0 起)
|
|
147
|
+
|
|
148
|
+
依赖 `pasm-skills>=0.5.0` 的认知层时自动启用,没有也能跑(退回字面匹配,功能降级不报错)。
|
|
149
|
+
|
|
150
|
+
| 能力 | 效果 |
|
|
151
|
+
|---|---|
|
|
152
|
+
| **语义检索** | 「我叫什么名字」能命中存成「姓名」的记忆(字面匹配做不到) |
|
|
153
|
+
| **遗忘曲线** | 久未唤起的记忆自然降权,学情更真实 |
|
|
154
|
+
| **记忆巩固** | 重复经历蒸馏成要点,记忆池不被撑爆 |
|
|
155
|
+
| **焦点栈** | 长对话不跑题 |
|
|
156
|
+
|
|
157
|
+
检索打分是可解释的:
|
|
158
|
+
|
|
159
|
+
```
|
|
160
|
+
score = 语义相似 × 0.62 + 记忆保留度 × 0.24 + 重要度 × 0.14 + 焦点加成
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
### 换更好的向量后端(可选)
|
|
164
|
+
|
|
165
|
+
内置后端是**零依赖离线**的字符 n-gram hashing + 中文同义扩展,开箱即用。
|
|
166
|
+
想要真正的语义向量,配一个 OpenAI 兼容的 embedding 接口即可自动接管:
|
|
167
|
+
|
|
168
|
+
```bash
|
|
169
|
+
export PASM_EMBED_URL="https://<your-endpoint>/v1/embeddings"
|
|
170
|
+
export PASM_EMBED_MODEL="bge-m3"
|
|
171
|
+
export PASM_EMBED_KEY="<key>"
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
也可以装 `sentence-transformers` 或 `fastembed`,会自动被识别。
|
|
175
|
+
`pasm_status` 会告诉你当前实际用的是哪个后端 —— **降级不隐藏**。
|
|
176
|
+
|
|
177
|
+
---
|
|
178
|
+
|
|
179
|
+
## 四、环境变量
|
|
180
|
+
|
|
181
|
+
| 变量 | 作用 |
|
|
182
|
+
|---|---|
|
|
183
|
+
| `PASM_MCP_PERSIST_DIR` | 状态落盘根目录,默认 `~/.pasm-mcp/` |
|
|
184
|
+
| `PASM_MCP_PERSONA` | 默认人格(JSON 字符串) |
|
|
185
|
+
| `PASM_SKILLS_PATH` | 本地开发逃生口:指向 `pasm-skills` 仓库根目录 |
|
|
186
|
+
| `PASM_EMBED_URL` / `_MODEL` / `_KEY` | 可选:外部 embedding 接口 |
|
|
187
|
+
|
|
188
|
+
---
|
|
189
|
+
|
|
190
|
+
## 五、PASM 在整条链路里的位置
|
|
191
|
+
|
|
192
|
+
它**不生成语言**。正确用法是:先把 `pasm_context` 的返回拼进提示词,再让你自己的模型说话。
|
|
193
|
+
|
|
194
|
+
```
|
|
195
|
+
用户说话 → pasm_context(query=用户的话) → 拿到 recalled / mood / action_pool
|
|
196
|
+
→ 拼进你的系统提示词 → 你的模型生成回复
|
|
197
|
+
→ pasm_observe(值得记的事) → pasm_feedback(用户反应)
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
---
|
|
201
|
+
|
|
202
|
+
## 六、生态中的位置
|
|
203
|
+
|
|
204
|
+
| 仓 | 角色 | 可见性 |
|
|
205
|
+
|---|---|---|
|
|
206
|
+
| `pasm-skills` | **基座**:`BaseAgent` + 认知能力层 | 公开 |
|
|
207
|
+
| `pasm-agents` | 成品智能体集(NPC / 陪伴 / 教学 / 验证) | 公开 |
|
|
208
|
+
| **`pasm-mcp-server`** | **本仓**:MCP 接入层 | 公开 |
|
|
209
|
+
| `PASM-Lite` | 教学版 + 认知引擎接口 | 公开 |
|
|
210
|
+
| `PASM` | 核心引擎(七层仿生 / 世界模型) | 私有 |
|
|
211
|
+
| `pasm-qclaw` | 桌面应用发行通道 | 公开 |
|
|
212
|
+
|
|
213
|
+
本包只依赖**公开**的 `pasm-skills`,不依赖私有核心。
|
|
214
|
+
装了核心的机器会自动从 `light` 档升到 `bionic` 档,没有也能正常跑。
|
|
215
|
+
|
|
216
|
+
---
|
|
217
|
+
|
|
218
|
+
## 七、打包发布(维护者)
|
|
219
|
+
|
|
220
|
+
```bash
|
|
221
|
+
python -m pip install --upgrade build twine
|
|
222
|
+
python -m build # 产出 dist/*.whl 与 dist/*.tar.gz
|
|
223
|
+
twine check dist/*
|
|
224
|
+
twine upload dist/* # 需要 PyPI token
|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
> GitHub Actions 流水线见 [`docs/publish-workflow.example.yml`](docs/publish-workflow.example.yml)
|
|
228
|
+
> (放到 `.github/workflows/publish.yml` 即生效;默认不放在那里是因为推送 workflow 需要
|
|
229
|
+
> PAT 带 `workflow` 权限)。
|
|
230
|
+
|
|
231
|
+
---
|
|
232
|
+
|
|
233
|
+
## 许可
|
|
234
|
+
|
|
235
|
+
MIT
|
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
# PASM MCP Server · 给任意 AI 客户端装上长期记忆
|
|
2
|
+
|
|
3
|
+
> **把 PASM 的认知内核暴露成标准 MCP 工具。**
|
|
4
|
+
> 你的大模型(IDE 插件 / 桌面 AI 客户端 / 自研 Agent)本身没有跨会话记忆、没有情绪连续性、
|
|
5
|
+
> 没有"被夸过就更爱做某件事"的行为倾向 —— 这个包就是给它补上这些。
|
|
6
|
+
|
|
7
|
+
**一句话定位**:PASM 不是"又一个聊天模型",是一个**认知器官** ——
|
|
8
|
+
记忆、情绪、行为倾向。语言生成仍然由你自己的模型负责。
|
|
9
|
+
|
|
10
|
+
```
|
|
11
|
+
┌──────────────────────────┐ MCP (stdio) ┌──────────────────────┐
|
|
12
|
+
│ 你的 AI 客户端 / Agent │ ◄─────────────► │ pasm-mcp-server │
|
|
13
|
+
│ (负责说话与推理) │ 工具调用 │ (负责记住与感受) │
|
|
14
|
+
└──────────────────────────┘ └──────────────────────┘
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## 〇、PASM 生态索引(六仓同频)
|
|
20
|
+
|
|
21
|
+
| 仓 | 角色 | 可见性 | 版本 |
|
|
22
|
+
|---|---|---|---|
|
|
23
|
+
| `pasm-skills` | 基座:`BaseAgent` + 认知能力层 | 公开 | 0.5.0 |
|
|
24
|
+
| `pasm-agents` | 成品智能体集(NPC / 陪伴 / 教学 / 验证) | 公开 | 0.4.5 |
|
|
25
|
+
| **`pasm-mcp-server`(本仓)** | **MCP 接入层:给任意 AI 客户端装长期记忆** | 公开 | **0.2.0** |
|
|
26
|
+
| `PASM-Lite` | 教学版 + 认知引擎接口 | 公开 | — |
|
|
27
|
+
| `PASM` | 核心引擎(七层仿生 / 世界模型) | **私有** | 0.7.2 |
|
|
28
|
+
| `pasm-qclaw` | 桌面应用发行通道 | 公开 | 0.29.1 |
|
|
29
|
+
|
|
30
|
+
流向:`PASM`(核心)→ `pasm-skills`(基座)→ `pasm-agents`(智能体)→
|
|
31
|
+
`pasm-mcp-server`(分发)→ `pasm-qclaw`(桌面产品);`PASM-Lite` 是面向外界的教学窗口。
|
|
32
|
+
|
|
33
|
+
地址:
|
|
34
|
+
[Gitee](https://gitee.com/arronzheng/pasm-mcp-server) ·
|
|
35
|
+
[GitHub](https://github.com/arronJack/pasm-mcp-server)
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## 一、快速开始
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
pip install pasm-mcp-server
|
|
43
|
+
pasm-mcp-server --selftest # 自检(16 项)
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
### 接入客户端(以 Cursor 为例)
|
|
47
|
+
|
|
48
|
+
写到 `.cursor/mcp.json`(项目级)或 `~/.cursor/mcp.json`(全局):
|
|
49
|
+
|
|
50
|
+
```json
|
|
51
|
+
{
|
|
52
|
+
"mcpServers": {
|
|
53
|
+
"pasm": {
|
|
54
|
+
"command": "python",
|
|
55
|
+
"args": ["-m", "pasm_mcp_server"]
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
> Windows 上如果 `python` 不在 PATH,把它换成绝对路径,例如 `"C:\\Python313\\python.exe"`。
|
|
62
|
+
|
|
63
|
+
### 各客户端配置位置
|
|
64
|
+
|
|
65
|
+
| 客户端 | 配置文件 | 字段形状 |
|
|
66
|
+
|---|---|---|
|
|
67
|
+
| **Cursor** | `.cursor/mcp.json` 或 `~/.cursor/mcp.json` | `mcpServers` |
|
|
68
|
+
| **Claude Desktop** | `%APPDATA%\Claude\claude_desktop_config.json`(macOS:`~/Library/Application Support/Claude/`) | `mcpServers` |
|
|
69
|
+
| **VS Code**(Copilot Agent) | `.vscode/mcp.json` | `servers` + `"type": "stdio"` |
|
|
70
|
+
| **自建 / 其他客户端** | 见 `examples/mcp_generic.json` | `mcpServers` |
|
|
71
|
+
|
|
72
|
+
现成文件:[`examples/mcp_cursor.json`](examples/mcp_cursor.json) ·
|
|
73
|
+
[`examples/mcp_claude_desktop.json`](examples/mcp_claude_desktop.json) ·
|
|
74
|
+
[`examples/mcp_vscode.json`](examples/mcp_vscode.json) ·
|
|
75
|
+
[`examples/mcp_generic.json`](examples/mcp_generic.json)
|
|
76
|
+
|
|
77
|
+
**校验是否接上**:`python examples/stdio_client_demo.py` —— 它会真的起一个子进程、
|
|
78
|
+
做完整握手、逐个调用工具(和真实客户端做的事一模一样)。
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## 二、工具有哪些(13 个)
|
|
83
|
+
|
|
84
|
+
### 认知核心
|
|
85
|
+
|
|
86
|
+
| 工具 | 干什么 |
|
|
87
|
+
|---|---|
|
|
88
|
+
| **`pasm_context`** ⭐ | **首选**。取"现在该记得什么 + 情绪如何 + 倾向做什么",拿去拼进提示词。只读,不写记忆 |
|
|
89
|
+
| `pasm_recall` | 记忆检索(装了认知层自动走语义) |
|
|
90
|
+
| `pasm_semantic` | 语义检索 + 可解释:换说法也能命中,并给出每条的融合分 / 语义分 / 记忆保留度 |
|
|
91
|
+
| `pasm_observe` | 把一件事写进长期记忆(重要度 1-5) |
|
|
92
|
+
| `pasm_feel` | 报告带情绪效价的事件,驱动情绪演化 |
|
|
93
|
+
| `pasm_act` | 按「人格 + 学到的偏好」选一个动作 |
|
|
94
|
+
| `pasm_feedback` | 反馈塑形(**务必带 `action`**) |
|
|
95
|
+
|
|
96
|
+
### 记忆维护
|
|
97
|
+
|
|
98
|
+
| 工具 | 干什么 |
|
|
99
|
+
|---|---|
|
|
100
|
+
| `pasm_focus` | 焦点栈:压入/查看"现在在聊什么",给检索加权 |
|
|
101
|
+
| `pasm_consolidate` | 记忆巩固(睡眠回放):把重复经历蒸馏成要点。默认只出建议 |
|
|
102
|
+
|
|
103
|
+
### 管理
|
|
104
|
+
|
|
105
|
+
| 工具 | 干什么 |
|
|
106
|
+
|---|---|
|
|
107
|
+
| `pasm_chat` | 完整认知回路对话一次(模板渲染,非 LLM) |
|
|
108
|
+
| `pasm_persona` | 查看/合并更新人格 |
|
|
109
|
+
| `pasm_status` | 状态快照(档位、记忆量、认知层后端、焦点、归档) |
|
|
110
|
+
| `pasm_save` | 立即落盘 |
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
## 三、认知能力(0.2.0 起)
|
|
115
|
+
|
|
116
|
+
依赖 `pasm-skills>=0.5.0` 的认知层时自动启用,没有也能跑(退回字面匹配,功能降级不报错)。
|
|
117
|
+
|
|
118
|
+
| 能力 | 效果 |
|
|
119
|
+
|---|---|
|
|
120
|
+
| **语义检索** | 「我叫什么名字」能命中存成「姓名」的记忆(字面匹配做不到) |
|
|
121
|
+
| **遗忘曲线** | 久未唤起的记忆自然降权,学情更真实 |
|
|
122
|
+
| **记忆巩固** | 重复经历蒸馏成要点,记忆池不被撑爆 |
|
|
123
|
+
| **焦点栈** | 长对话不跑题 |
|
|
124
|
+
|
|
125
|
+
检索打分是可解释的:
|
|
126
|
+
|
|
127
|
+
```
|
|
128
|
+
score = 语义相似 × 0.62 + 记忆保留度 × 0.24 + 重要度 × 0.14 + 焦点加成
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
### 换更好的向量后端(可选)
|
|
132
|
+
|
|
133
|
+
内置后端是**零依赖离线**的字符 n-gram hashing + 中文同义扩展,开箱即用。
|
|
134
|
+
想要真正的语义向量,配一个 OpenAI 兼容的 embedding 接口即可自动接管:
|
|
135
|
+
|
|
136
|
+
```bash
|
|
137
|
+
export PASM_EMBED_URL="https://<your-endpoint>/v1/embeddings"
|
|
138
|
+
export PASM_EMBED_MODEL="bge-m3"
|
|
139
|
+
export PASM_EMBED_KEY="<key>"
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
也可以装 `sentence-transformers` 或 `fastembed`,会自动被识别。
|
|
143
|
+
`pasm_status` 会告诉你当前实际用的是哪个后端 —— **降级不隐藏**。
|
|
144
|
+
|
|
145
|
+
---
|
|
146
|
+
|
|
147
|
+
## 四、环境变量
|
|
148
|
+
|
|
149
|
+
| 变量 | 作用 |
|
|
150
|
+
|---|---|
|
|
151
|
+
| `PASM_MCP_PERSIST_DIR` | 状态落盘根目录,默认 `~/.pasm-mcp/` |
|
|
152
|
+
| `PASM_MCP_PERSONA` | 默认人格(JSON 字符串) |
|
|
153
|
+
| `PASM_SKILLS_PATH` | 本地开发逃生口:指向 `pasm-skills` 仓库根目录 |
|
|
154
|
+
| `PASM_EMBED_URL` / `_MODEL` / `_KEY` | 可选:外部 embedding 接口 |
|
|
155
|
+
|
|
156
|
+
---
|
|
157
|
+
|
|
158
|
+
## 五、PASM 在整条链路里的位置
|
|
159
|
+
|
|
160
|
+
它**不生成语言**。正确用法是:先把 `pasm_context` 的返回拼进提示词,再让你自己的模型说话。
|
|
161
|
+
|
|
162
|
+
```
|
|
163
|
+
用户说话 → pasm_context(query=用户的话) → 拿到 recalled / mood / action_pool
|
|
164
|
+
→ 拼进你的系统提示词 → 你的模型生成回复
|
|
165
|
+
→ pasm_observe(值得记的事) → pasm_feedback(用户反应)
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
---
|
|
169
|
+
|
|
170
|
+
## 六、生态中的位置
|
|
171
|
+
|
|
172
|
+
| 仓 | 角色 | 可见性 |
|
|
173
|
+
|---|---|---|
|
|
174
|
+
| `pasm-skills` | **基座**:`BaseAgent` + 认知能力层 | 公开 |
|
|
175
|
+
| `pasm-agents` | 成品智能体集(NPC / 陪伴 / 教学 / 验证) | 公开 |
|
|
176
|
+
| **`pasm-mcp-server`** | **本仓**:MCP 接入层 | 公开 |
|
|
177
|
+
| `PASM-Lite` | 教学版 + 认知引擎接口 | 公开 |
|
|
178
|
+
| `PASM` | 核心引擎(七层仿生 / 世界模型) | 私有 |
|
|
179
|
+
| `pasm-qclaw` | 桌面应用发行通道 | 公开 |
|
|
180
|
+
|
|
181
|
+
本包只依赖**公开**的 `pasm-skills`,不依赖私有核心。
|
|
182
|
+
装了核心的机器会自动从 `light` 档升到 `bionic` 档,没有也能正常跑。
|
|
183
|
+
|
|
184
|
+
---
|
|
185
|
+
|
|
186
|
+
## 七、打包发布(维护者)
|
|
187
|
+
|
|
188
|
+
```bash
|
|
189
|
+
python -m pip install --upgrade build twine
|
|
190
|
+
python -m build # 产出 dist/*.whl 与 dist/*.tar.gz
|
|
191
|
+
twine check dist/*
|
|
192
|
+
twine upload dist/* # 需要 PyPI token
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
> GitHub Actions 流水线见 [`docs/publish-workflow.example.yml`](docs/publish-workflow.example.yml)
|
|
196
|
+
> (放到 `.github/workflows/publish.yml` 即生效;默认不放在那里是因为推送 workflow 需要
|
|
197
|
+
> PAT 带 `workflow` 权限)。
|
|
198
|
+
|
|
199
|
+
---
|
|
200
|
+
|
|
201
|
+
## 许可
|
|
202
|
+
|
|
203
|
+
MIT
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
{
|
|
2
|
+
"_comment": "Claude Desktop 接入配置。文件位置:Windows %APPDATA%\\Claude\\claude_desktop_config.json ;macOS ~/Library/Application Support/Claude/claude_desktop_config.json",
|
|
3
|
+
"mcpServers": {
|
|
4
|
+
"pasm": {
|
|
5
|
+
"command": "python",
|
|
6
|
+
"args": ["-m", "pasm_mcp_server"],
|
|
7
|
+
"env": {
|
|
8
|
+
"PASM_MCP_PERSIST_DIR": ""
|
|
9
|
+
}
|
|
10
|
+
}
|
|
11
|
+
}
|
|
12
|
+
}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
{
|
|
2
|
+
"_comment": "Cursor 接入配置。写到项目根目录 .cursor/mcp.json(项目级)或 ~/.cursor/mcp.json(全局)。",
|
|
3
|
+
"_docs": "https://docs.cursor.com/context/mcp",
|
|
4
|
+
"mcpServers": {
|
|
5
|
+
"pasm": {
|
|
6
|
+
"command": "python",
|
|
7
|
+
"args": ["-m", "pasm_mcp_server"],
|
|
8
|
+
"env": {
|
|
9
|
+
"PASM_MCP_PERSIST_DIR": ""
|
|
10
|
+
}
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
{
|
|
2
|
+
"_comment": "通用 stdio MCP 客户端配置。多数支持 MCP 的桌面客户端(自建 Agent / 各类 AI 客户端)都吃这个形状:mcpServers + command + args + env。",
|
|
3
|
+
"_docs": "https://modelcontextprotocol.io",
|
|
4
|
+
"mcpServers": {
|
|
5
|
+
"pasm": {
|
|
6
|
+
"command": "python",
|
|
7
|
+
"args": ["-m", "pasm_mcp_server"],
|
|
8
|
+
"env": {
|
|
9
|
+
"PASM_MCP_PERSIST_DIR": "",
|
|
10
|
+
"PASM_EMBED_URL": "",
|
|
11
|
+
"PASM_EMBED_MODEL": "",
|
|
12
|
+
"PASM_EMBED_KEY": ""
|
|
13
|
+
},
|
|
14
|
+
"disabled": false
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
{
|
|
2
|
+
"_comment": "VS Code(Copilot Agent 模式)接入配置。写到项目根目录 .vscode/mcp.json。注意字段名是 servers(不是 mcpServers),且需要显式 type。",
|
|
3
|
+
"_docs": "https://code.visualstudio.com/docs/copilot/chat/mcp-servers",
|
|
4
|
+
"servers": {
|
|
5
|
+
"pasm": {
|
|
6
|
+
"type": "stdio",
|
|
7
|
+
"command": "python",
|
|
8
|
+
"args": ["-m", "pasm_mcp_server"],
|
|
9
|
+
"env": {
|
|
10
|
+
"PASM_MCP_PERSIST_DIR": ""
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
}
|
|
14
|
+
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
"""pasm-mcp-server —— 把 PASM 认知内核暴露成标准 MCP 工具。
|
|
2
|
+
|
|
3
|
+
PASM 的核心资产是**长期记忆、连续情绪、被反馈塑形的行为倾向** ——
|
|
4
|
+
这些恰好是大模型原生缺失的。本包不提供"又一个聊天模型",
|
|
5
|
+
而是做一个**认知器官**:任何支持 MCP 的客户端(桌面 AI 客户端、IDE 插件、自建 Agent、
|
|
6
|
+
Cursor、自研 Agent)都能把它挂上去,让自己的模型获得跨会话的认知连续性。
|
|
7
|
+
|
|
8
|
+
三分钟上手
|
|
9
|
+
----------
|
|
10
|
+
|
|
11
|
+
pip install pasm-mcp-server
|
|
12
|
+
pasm-mcp-server --selftest # 先自检,确认安装可用
|
|
13
|
+
|
|
14
|
+
然后在客户端里注册一个 stdio server:
|
|
15
|
+
|
|
16
|
+
command: python
|
|
17
|
+
args: ["-m", "pasm_mcp_server"]
|
|
18
|
+
|
|
19
|
+
最常用的是 `pasm_context`:它返回"此刻该记得什么 + 情绪如何 + 倾向做什么",
|
|
20
|
+
客户端把它拼进自己的提示词,就得到了一个**有记忆、有情绪、会成长**的智能体。
|
|
21
|
+
"""
|
|
22
|
+
from __future__ import annotations
|
|
23
|
+
|
|
24
|
+
__version__ = "0.2.0"
|
|
25
|
+
|
|
26
|
+
__all__ = ["__version__"]
|