MCP--Quitto服务器
主控制协议（Master Control Protocol）
______________________________________________________________________
描述
MCP（主控制协议）是一个模块化平台，用于本地和家庭实验室环境中的编排，控制和自动化。存储库包括一个主服务器（MCP Server），它实现了主控制协议，并充当生态系统的中心编排器：管理上下文模型，展示控制 API，协调服务并维护组件之间的凝聚力。
该项目提供了服务，仓库和实用程序，用于创建，测试和操作由该协议控制的组件，具有静态Web界面和命令行工具。
索引
- 主控制协议（Master Control Protocol） - 功能 - 架构和组件 - 技术定义 — 分离 MCP 和 MCP Server - 在哪里查看代码（参考文件） - 快速示例：跟踪请求的流程 - 快速安装 - 配置 - 执行和使用 - 开发 - 贡献 - 解决问题 - 链接úteis - 许可证
功能
- MCP协议：服务之间协调的消息和标准。
- 模块化服务集（MCPService，MachineService，WebService）。
- 用于查看和基本操作的静态 Web 界面（文件夹）
web/). - 轻度持久性的本地仓库（ 文件夹）
Repository/). - 用于创建和配置项目的辅助脚本。
架构和组件
Usuario Web UI / CLI
|
Server (orquestrador)
|
Services (src/Services/)
|
Repositories / DB (Repository/, DB/)
|
Domain Models (models/)主要目录 ：
src/主要源代码（服务、编排器、入口点脚本）。src/Services/实现的服务（MCPService，MachineService，WebService等）。src/server.py或src/index.py— 主服务器（MCP Server/Orchestrator）的入口点。models/域名模型（User,Machine,Agent).Repository/— 持久性实施和存储库。web/— 静态文件（HTML/CSS/JS）用于最小的控制/可视化。
主服务器（MCP服务器）
MCP 服务器实现模型上下文协议，主要负责：
- 管理模型上下文和全球生态系统状态。
- 向客户端展示控制 API（CLI、UI、外部集成）。
- 组织服务和仓库之间的通信。
- 验证/授权请求并应用操作策略。
在高级生产或测试环境中，MCP 服务器是协调高级操作的核心组件。
技术定义 — 分离 MCP 和 MCP Server
为了避免含糊不清，“MCP”一词在这里指的是主控制协议（Master Control Protocol）——一组用于协调组件的消息、命令和上下文模型。 “MCP Server”是该协议在存储库中的具体实现，以及处理消息、维护状态和暴露 API 的编排器。
- MCP（主控制协议）：逻辑规范——消息格式、上下文模型合约、命令和事件。
- MCP服务器：协议实现，负责解释MCP消息，应用业务规则，协调服务和持续状态。
在哪里查看代码（参考文件）
- 入口点/ 编排器 ： src/index.py
- MCP 协议实现： src/服务/MCP/MCPService.py
- 内存状态 / 上下文管理 ： src/服务/MCP/内存服务.py
- 前端（Frontend/API）： src/服务/WebService.py
- 银行/存储连接： src/DB/DBConnection.py
- 示例仓库（主机、用户）： 存储库/机器/机器存储库.py e 存储库/用户/用户存储库.py
阅读上面的文件以了解协议的定义（类型，消息）以及服务器如何在运行时处理这些消息。
快速示例：跟踪请求的流程
- 客户端（CLI 或 Web UI）发送创建/更新上下文的请求。
- MCP 服务器（进入点）接收请求并将其转发到
MCPService. MCPService根据 MCP 协议验证消息并使用MemoryService更新状态的/ 仓库 。- 结果持续通过
src/DB/DBConnection.py/Repository/*然后回复给客户。
要在本地测试，请启动服务器并观察上述流中的日志/打印：
python src/index.py然后打开 web/index.html 或者使用 HTTP/CLI 客户端向 MCP 服务器发送命令。
快速安装
最低要求：
- Python 3.8或更高级
- Git
快速命令：
git clone https://github.com/yourusername/mcp.git
cd mcp
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt || true注意：有些服务不依赖于外部软件包，可以直接在安装 Python 的情况下运行。
配置
设置可以通过环境变量或文件设置 .env （不要参与）
推荐的例子 .env （项目根）：
MCP_ENV=development
DB_PATH=./DB/data.sqlite
WEB_PORT=8080检查 src/DB/DBConnection.py e src/Services/* 特定服务参数。
执行和使用
通用入口点/主服务器
主服务器（MCP 编排器）可以从项目的入口点启动。例如：
# Inicia o servidor principal (se presente)
python src/server.py
# Alternativa: alguns distribuídos usam index.py como entrypoint
python src/index.py单个服务可以直接运行用于隔离测试（请参阅下面的每个模块）。 src/Services/).
Web界面（静态）
打开 web/index.html 通过简单的静态服务器或运行 WebService 通过HTTP服务文件，允许MCP服务器服务API，前端消耗数据。
开发
仓库结构摘要 ：
src/
├── Services/
├── DB/
└── index.py
models/
Repository/
web/- 在打开 PR 之前编写关键功能测试。
- 更喜欢小的描述性提交。
贡献
建议的过程 ：
- 仓库分叉
- 创建分支 ：
git checkout -b feature/nome-da-feature - 实施和测试更改
- 打开Pull Request并清楚描述更改
包括测试，并在适用时更新文档。
解决问题
服务未启动 ：
- 请检查虚拟环境是否已启用 。
- 确认依赖安装 。
- 检查权限
DB_PATH使用中的门。
导入错误 ：
- 确认
PYTHONPATH启动 venv。
链接úteis
- pythonhttps://www.python.org/
- VS代码：https://code.visualstudio.com/
许可证
获得MIT许可证。查看文件 LICENSE 到全文。
______________________________________________________________________
这是 README 已合并以删除重复内容和合并标记。如果您喜欢，我可以：
- 以英文提供文本 。
- 添加 CI/覆盖面徽章（例如 GitHub Actions）。
- 编写特定的 quickstart
MCPService,WebService或MachineService.
指定选项或请求其他调整 。