Quitto Server

MCP--Quitto服务器

主控制协议（Master Control Protocol）

 

______________________________________________________________________

描述

MCP（主控制协议）是一个模块化平台，用于本地和家庭实验室环境中的编排，控制和自动化。存储库包括一个主服务器（MCP Server），它实现了主控制协议，并充当生态系统的中心编排器：管理上下文模型，展示控制 API，协调服务并维护组件之间的凝聚力。

该项目提供了服务，仓库和实用程序，用于创建，测试和操作由该协议控制的组件，具有静态Web界面和命令行工具。

索引

• MCP--Quitto服务器

- 主控制协议（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

阅读上面的文件以了解协议的定义（类型，消息）以及服务器如何在运行时处理这些消息。

快速示例：跟踪请求的流程

1. 客户端（CLI 或 Web UI）发送创建/更新上下文的请求。
2. MCP 服务器（进入点）接收请求并将其转发到 MCPService.
3. MCPService 根据 MCP 协议验证消息并使用 MemoryService 更新状态的/ 仓库 。
4. 结果持续通过 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 之前编写关键功能测试。
• 更喜欢小的描述性提交。

贡献

建议的过程 ：

1. 仓库分叉
2. 创建分支 ： git checkout -b feature/nome-da-feature
3. 实施和测试更改
4. 打开Pull Request并清楚描述更改

包括测试，并在适用时更新文档。

解决问题

服务未启动 ：

• 请检查虚拟环境是否已启用 。
• 确认依赖安装 。
• 检查权限 DB_PATH 使用中的门。

导入错误 ：

• 确认 PYTHONPATH 启动 venv。

链接úteis

• pythonhttps://www.python.org/
• VS代码：https://code.visualstudio.com/

许可证

获得MIT许可证。查看文件 LICENSE 到全文。

______________________________________________________________________

这是 README 已合并以删除重复内容和合并标记。如果您喜欢，我可以：

1. 以英文提供文本 。
2. 添加 CI/覆盖面徽章（例如 GitHub Actions）。
3. 编写特定的 quickstart MCPService, WebService 或 MachineService.

指定选项或请求其他调整 。