Tpc Server

🚀 🧩 TPC 服務器 ✨

TPC 服務器可跟蹤代理（或項目）的思考過程 🧠、計劃 📝 和變更記錄 ✅。它提供後端服務，用於記錄、存儲和檢索 AI 代理或協作項目中的推理過程、意圖行為和執行步驟。該服務器基於 FastAPI、MCP - Server 和 SQLAlchemy 構建。

🚀 快速開始

安裝與設置

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 文件。
• 🪄 自動錶創建：第一次運行時自動創建數據庫表（如果不存在）。

📚 詳細文檔

🤔 什麼是 TPC？

核心思想是創建一個結構化且相互關聯的日誌：

• 思考（🧠）：記錄見解、想法、觀察結果、考慮事項或行動之前的數據點。
• 計劃（📝）：定義意圖採取的行動、策略、目標或方法，通常源自於思考過程。
• 變更（✅）：記錄實際執行的操作或修改，通常與特定計劃相關聯。 此服務器有助於記錄這些項目及其關係（思考 <-> 計劃 -> 變更）。

📋 數據庫

• 默認使用 SQLite 文件（tpc_server.db）位於項目目錄中 - 簡單且無需單獨的數據庫服務器。
• 通過更改 .env 中的 DATABASE_URL 並安裝相應的驅動程序（例如 pip install psycopg2-binary），可以輕鬆切換到 PostgreSQL、MySQL 等其他數據庫。
• 表由 SQLAlchemy 在啟動時自動創建，如果表不存在。

🙌 貢獻

歡迎貢獻、問題和功能請求！請隨意查看 issues page 或提交 pull request。