AOE2 MCP Monorepo
一个包含Age of Empires 2库和用TypeScript构建的MCP服务器的monorepo。
概述
此monorepo包含两个包：
aoe2-lib：导出的库包queryUnit以及查询AOE2单元需求的相关功能aoe2-mcp：使用库通过模型上下文协议提供AOE2单元查询的MCP服务器
MCP服务器包括：
- 工具：MCP客户端可以调用的可执行函数
- 资源：MCP客户端可以读取的数据源
- 提示：MCP客户端可以使用的模板提示
先决条件
- Node.js>=18.0.0
- npm
安装
- 安装依赖项：
npm install- 构建项目：
npm run build发展
构建
将TypeScript编译为JavaScript：
npm run build观看模式
根据文件更改自动重建：
npm run dev跑
启动MCP服务器：
npm start代码质量
读取代码：
npm run lint设置代码格式：
npm run format无建筑物的类型检查：
npm run type-check项目结构
aoe2-mcp/
├── packages/
│ ├── aoe2-lib/ # Library package
│ │ ├── src/
│ │ │ ├── index.ts # Main exports (queryUnit, types, etc.)
│ │ │ ├── tools/
│ │ │ │ └── queryUnit.ts
│ │ │ ├── data/
│ │ │ │ └── units/
│ │ │ └── config/
│ │ │ └── resources.ts
│ │ ├── package.json
│ │ └── tsconfig.json
│ └── aoe2-mcp/ # MCP server package
│ ├── src/
│ │ └── index.ts # MCP server (imports from aoe2-lib)
│ ├── package.json
│ └── tsconfig.json
├── package.json # Root workspace config
└── README.md用法
STDIO传输
默认情况下，服务器使用STDIO传输，这与Claude Desktop、Cursor和其他MCP兼容应用程序等MCP客户端兼容。
要与MCP客户端一起使用，请将其配置为运行：
node /path/to/aoe2-mcp/packages/aoe2-mcp/dist/index.js示例工具
该服务器包括一个示例计算器工具，用于演示：
- 工具注册
- 输入模式验证
- 错误处理
- 响应格式
示例资源
服务器包含一个示例资源，用于演示：
- 资源列表
- 资源阅读
- 内容格式
示例提示
服务器包含一个示例提示模板，演示：
- 快速上市
- 及时处理争论
- 邮件格式
扩展服务器
添加新工具
- 将工具定义添加到
ListToolsRequestSchema处理器 - 在中实现工具逻辑
CallToolRequestSchema处理器 - 适当处理错误
添加新资源
- 将资源定义添加到
ListResourcesRequestSchema处理器 - 在中实现资源读取逻辑
ReadResourceRequestSchema处理器
添加新提示
- 将提示定义添加到
ListPromptsRequestSchema处理器 - 在中实现提示逻辑
GetPromptRequestSchema处理器
许可证
麻省理工学院