🧩 TPC 服务器 ✨

跟踪您的代理（或项目）的思考过程 🧠、计划 📝 和变更记录 ✅！

TPC 服务器提供一个后端服务，用于记录、存储和检索 AI 代理或协作项目中推理过程、意图行为和执行步骤。该服务器使用 FastAPI、MCP-Server 和 SQLAlchemy 构建。

🤔 什么是 TPC？

核心思想是创建一个结构化且相互关联的日志：

• **思考（🧠）：**记录见解、想法、观察结果、考虑事项或行动之前的数据点。
• **计划（📝）：**定义意图采取的行动、策略、目标或方法，通常源自于思考过程。
• **变更（✅）：**记录实际执行的操作或修改，通常与特定计划相关联。

此服务器有助于记录这些项目及其关系（思考 <-> 计划 -> 变更）。

🚀 功能

• **🧠 跟踪思考、📝 制定计划和 ✅ 记录变更：**为每个概念提供专用模型和存储。
• **🔗 相互关联的数据：**将思考与计划（多对多）、变更为特定计划执行的步骤（多对一）相关联。
• **🌐 网页界面：**简单 HTML 视图，用于浏览最近活动、思考、计划和变更记录。
• **🔌 JSON API：**提供端点进行程序化数据检索（最近活动、所有思考/计划/变更）。
• **🤖 代理工具（MCP）：**通过 mcp-server 提供函数，使 AI 代理能够与 TPC 存储交互（add_thought、create_plan、log_change、get_...）。
• **💾 数据库后端：**使用 SQLAlchemy，默认为 SQLite，可通过 URL 易配置到其他数据库。
• **⚙️ 可配置性：**设置 DB URL、主机、端口和代理通信传输（SSE/stdio）通过 .env 文件。
• **🪄 自动表创建：**第一次运行时自动创建数据库表（如果不存在）。

🛠️ 安装与设置

1. 克隆仓库：

   git clone [https://github.com/suttonwilliamd/tpc-server.git](https://github.com/suttonwilliamd/tpc-server.git)
   cd tpc-server
   

2. 创建并激活虚拟环境：

   # 创建环境
   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
   

3. 安装依赖项：

   使用以下命令进行安装：
   ```bash
   pip install -r requirements.txt
   

4. 配置环境： 在项目根目录中创建一个 .env 文件：

   DATABASE_URL=sqlite:///tpc_server.db
   

5. 运行服务器：

   python main.py
   

📋 数据库

• 默认使用 SQLite 文件（tpc_server.db）位于项目目录中 - 简单且无需单独的数据库服务器。
• 通过更改 .env 中的 DATABASE_URL 并安装相应的驱动程序（例如 pip install psycopg2-binary），可以轻松切换到 PostgreSQL、MySQL 等其他数据库。
• 表由 SQLAlchemy 在启动时自动创建，如果表不存在。

🙌 贡献

欢迎贡献、问题和功能请求！请随意查看 issues page 或提交pull request。