MCPControl 项目启动与配置教程

1. 项目目录结构及介绍

MCPControl 项目是一个用于Windows操作系统的服务器，它通过Model Context Protocol (MCP) 提供对系统操作的程序化控制，包括鼠标、键盘、窗口管理以及屏幕捕获功能。以下是项目的目录结构及各部分的简要介绍：

MCPControl/
├── .claude/                  # Claude 配置文件
├── .git/                     # Git 仓库信息
├── .github/                  # GitHub 工作流和模板
├── .husky/                   # Husky 配置文件，用于Git钩子
├── docs/                     # 项目文档
├── scripts/                  # 脚本文件
├── src/                      # 源代码目录
├── test/                     # 测试文件目录
├── .gitignore                # Git 忽略文件列表
├── .lintstagedrc             # Lint-staged 配置文件
├── .prettierrc               # Prettier 配置文件
├── CLAUDE.md                 # Claude 项目相关文档
├── CONTRIBUTING.md           # 贡献指南
├── LICENSE                   # 项目许可证
├── README.md                 # 项目自述文件
├── RELEASE_NOTES_v0.2.0.md   # 版本发布说明
├── eslint.config.js          # ESLint 配置文件
├── mcpcontrol-wrapper.sh      # MCPControl 包装脚本
├── package-lock.json         # npm 包锁定文件
├── package.json              # npm 包配置文件
├── test-autohotkey-direct.js # AutoHotkey 测试脚本
├── test-autohotkey.js        # AutoHotkey 测试脚本
├── test-panel.html           # 测试界面HTML文件
├── tsconfig.json             # TypeScript 配置文件
└── vitest.config.ts          # Vitest 配置文件

2. 项目的启动文件介绍

项目的启动主要通过 mcp-control 命令来实现。这个命令是项目的主要启动脚本，它位于项目的根目录中。启动文件通常位于 src/ 目录下，例如：

src/mcp-control.ts

这个文件包含了启动MCPControl服务器所需的逻辑，包括创建服务器实例、监听端口、设置SSE（Server-Sent Events）等。

启动MCPControl服务器的命令如下：

mcp-control --sse

可以使用不同的参数来启动服务器，例如指定端口号或启用HTTPS等。

3. 项目的配置文件介绍

MCPControl项目的配置主要通过 package.json 文件来进行。以下是 package.json 文件中的一些关键配置：

{
  "name": "mcp-control",
  "version": "0.2.0",
  "description": "Windows control server for the Model Context Protocol",
  "main": "src/mcp-control.js",
  "scripts": {
    "start": "mcp-control --sse",
    "test": "vitest"
  },
  "dependencies": {
    // 项目的依赖库
  },
  "devDependencies": {
    // 开发依赖库
  },
  "engines": {
    "node": ">=14.17.0"
  }
}

在这个文件中，scripts 部分定义了启动项目的脚本以及运行测试的脚本。dependencies 部分列出了项目运行时所需的依赖库，而 devDependencies 则列出了开发过程中需要的库。

项目的配置还包括其他文件，如 .prettierrc 用于配置代码格式化，.eslintrc.js 用于配置ESLint代码检查规则等。这些配置文件确保代码的一致性和质量。