Tpc Server

🚀 🧩 TPC 服务器 ✨

TPC 服务器能够跟踪您的代理（或项目）的思考过程 🧠、计划 📝 和变更记录 ✅。它提供了一个后端服务，可用于记录、存储和检索 AI 代理或协作项目中的推理过程、意图行为和执行步骤。该服务器基于 FastAPI、MCP - Server 和 SQLAlchemy 构建。

🚀 快速开始

TPC 服务器提供了便捷的使用方式，以下是快速启动的步骤：

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. 安装依赖项： 使用以下命令进行安装：

   pip install -r requirements.txt
   

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

   DATABASE_URL=sqlite:///tpc_server.db
   

5. 运行服务器：

   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。