🚀 🧩 TPC 服务器 ✨
TPC 服务器能够跟踪您的代理（或项目）的思考过程 🧠、计划 📝 和变更记录 ✅。它提供了一个后端服务，可用于记录、存储和检索 AI 代理或协作项目中的推理过程、意图行为和执行步骤。该服务器基于 FastAPI、MCP - Server 和 SQLAlchemy 构建。
🚀 快速开始
TPC 服务器提供了便捷的使用方式，以下是快速启动的步骤：
- 克隆仓库：
git clone [https://github.com/suttonwilliamd/tpc-server.git](https://github.com/suttonwilliamd/tpc-server.git) cd tpc-server - 创建并激活虚拟环境：
# 创建环境 python -m venv venv # 激活（macOS/Linux） source venv/bin/activate # 激活（Windows - Git Bash/WSL） source venv/Scripts/activate # 激活（Windows - Command Prompt/PowerShell） .\venv\Scripts\activate - 安装依赖项：
使用以下命令进行安装：
pip install -r requirements.txt - 配置环境：
在项目根目录中创建一个
.env文件：DATABASE_URL=sqlite:///tpc_server.db - 运行服务器：
python main.py
✨ 主要特性
- 🧠 跟踪思考、📝 制定计划和 ✅ 记录变更：为每个概念提供专用模型和存储。
- 🔗 相互关联的数据：将思考与计划（多对多）、变更为特定计划执行的步骤（多对一）相关联。
- 🌐 网页界面：简单 HTML 视图，用于浏览最近活动、思考、计划和变更记录。
- 🔌 JSON API：提供端点进行程序化数据检索（最近活动、所有思考/计划/变更）。
- 🤖 代理工具（MCP）：通过
mcp-server提供函数，使 AI 代理能够与 TPC 存储交互（add_thought、create_plan、log_change、get_...）。 - 💾 数据库后端：使用 SQLAlchemy，默认为 SQLite，可通过 URL 易配置到其他数据库。
- ⚙️ 可配置性：设置 DB URL、主机、端口和代理通信传输（SSE/stdio）通过
.env文件。 - 🪄 自动表创建：第一次运行时自动创建数据库表（如果不存在）。
📦 安装指南
克隆仓库
git clone [https://github.com/suttonwilliamd/tpc-server.git](https://github.com/suttonwilliamd/tpc-server.git)
cd tpc-server
创建并激活虚拟环境
# 创建环境
python -m venv venv
# 激活（macOS/Linux）
source venv/bin/activate
# 激活（Windows - Git Bash/WSL）
source venv/Scripts/activate
# 激活（Windows - Command Prompt/PowerShell）
.\venv\Scripts\activate
安装依赖项
pip install -r requirements.txt
配置环境
在项目根目录中创建一个 .env 文件：
DATABASE_URL=sqlite:///tpc_server.db
运行服务器
python main.py
📚 详细文档
🤔 什么是 TPC？
核心思想是创建一个结构化且相互关联的日志：
- 思考（🧠）：记录见解、想法、观察结果、考虑事项或行动之前的数据点。
- 计划（📝）：定义意图采取的行动、策略、目标或方法，通常源自于思考过程。
- 变更（✅）：记录实际执行的操作或修改，通常与特定计划相关联。
此服务器有助于记录这些项目及其关系（思考 <-> 计划 -> 变更）。
📋 数据库
- 默认使用 SQLite 文件（
tpc_server.db）位于项目目录中，简单且无需单独的数据库服务器。 - 通过更改
.env中的DATABASE_URL并安装相应的驱动程序（例如pip install psycopg2-binary），可以轻松切换到 PostgreSQL、MySQL 等其他数据库。 - 表由 SQLAlchemy 在启动时自动创建，如果表不存在。
🙌 贡献
欢迎贡献、问题和功能请求！请随意查看 issues page 或提交 pull request。