用于人工智能驱动Next.js项目管理的MCP服务器
轻量级的 模型上下文协议（MCP） 服务器，通过提供精心策划的依赖类别、约定集和阅读和更新工具，帮助AI编码代理管理Next.js项目 package.json 文件夹。该服务器使AI代理能够在没有人工干预的情况下，对项目依赖关系和约定做出明智的决定。
为什么选择此存储库
该存储库为AI编码代理提供了一种结构化的方式：
- 发现并选择 Next.js项目的适当依赖类别。
- 应用惯例 符合项目要求和最佳实践。
- 阅读并更新
package.json以编程方式创建文件。 - 运行棉绒检查 以确保代码质量和一致性。
通过使用此MCP服务器，AI代理可以专注于解决问题，而不是管理项目设置和配置。
背景
在人工智能驱动的开发工作流程中，代理通常需要对项目依赖关系和约定做出决定。此MCP服务器充当AI代理和项目配置之间的桥梁，提供了一种结构化的方式来管理依赖关系和约定。
服务器使用TypeScript构建，并使用 @modelcontextprotocol/sdk 公开AI代理可以用来与项目配置交互的工具。
用例
- 依赖管理：AI代理可以列出可用的依赖类别，选择合适的类别，并将其应用于项目
package.json文件。 - 公约执行：AI代理可以列出可用的约定集，选择相关约定集，并将其应用于项目的配置。
- 代码质量：AI代理可以运行lint检查以确保代码质量和一致性。
- 项目设置：AI代理可以创建新的
package.json文件中包含新项目的适当依赖关系和约定。
快速开始
要开始使用用于AI驱动Next.js项目管理的MCP服务器，请按照以下步骤操作：
- 再进行:
pnpm install- 构建服务器:
pnpm build- 启动服务器:
pnpm start- 以开发模式运行:
pnpm dev详细安装和使用
安装
- 克隆存储库：
git clone https://github.com/your-username/simple-ai-coding-agent-mcp-server.git- 导航到项目目录：
cd simple-ai-coding-agent-mcp-server- 安装依赖项：
pnpm install用法
- 构建服务器:
pnpm build- 启动服务器:
pnpm start- 以开发模式运行:
pnpm dev命令行选项
您可以在启动服务器时通过传递命令行参数来控制哪些工具可用：
--disable-read-deps：禁用read_current_dependencies工具。--disable-apply-deps：禁用apply_dependencies_to_package_json工具。
例子
# Disable only the read dependencies tool
node ./dist/server.js --disable-read-deps
# Disable only the apply dependencies tool
node ./dist/server.js --disable-apply-deps
# Disable both tools
node ./dist/server.js --disable-read-deps --disable-apply-deps
# Default behavior (both tools enabled)
node ./dist/server.js工具合同
此服务器公开以下MCP工具：
- 列表_类别：返回包含每个类别描述的完整目录。
- 选择_空：返回一个即用型提示，让LLM根据任务从目录中选择类别。
- list_惯例：对项目护栏进行编码的曲面约定集。
- 惯例_选择_豁免：提供一个即用型提示，用于为任务选择正确的约定集。
- 惯例_建议：将所请求的约定集格式化为markdown，以便
AGENTS.md或一般工作流提示。 - resolve_conventions：返回所选约定键的结构化指南数据。
- resolve_dependency：合并所选类别的依赖关系/devDependencies，并返回单个计划。
- read_current_依赖关系：从读取依赖项/devDependencies
package.json（如果存在）。 - 应用程序依赖性to-package_json：创建/更新
package.json通过合并已解决的计划。 - run_lint_checks：对更改的文件运行lint暂存命令并返回错误摘要。
LLM流量（建议）
- 呼叫
list_categories检索目录。 - 使用以下文本
selection_prompt以决定哪些类别适合用户的任务。 - 呼叫
resolve_dependencies使用所选的类别键来获取合并的依赖计划。 - （可选）呼叫
read_current_dependencies查看存储库中已经存在的内容。 - 呼叫
apply_dependencies_to_package_json无论是categories或plan从步骤3开始。
会议工作流程
- 呼叫
list_conventions检查可用的护栏组。 - 把手
conventions_selection_prompt将文本发送到LLM，以便它可以为任务选择相关的约定密钥。 - 使用
resolve_conventions获取所选键的结构化指南有效载荷（非常适合仪表板或审计）。 - 将相同的密钥输入
conventions_prompt获取格式丰富的指南AGENTS.md或其他文档。
开发进度
用于AI驱动的Next.js项目管理的MCP服务器正在积极维护和更新。以下是最近的一些发展：
- 依赖管理：AI代理现在可以列出、选择依赖类别并将其应用于项目的
package.json文件。 - 公约执行：AI代理可以列出、选择约定集并将其应用于项目的配置。
- 代码质量：AI代理可以运行lint检查以确保代码质量和一致性。
- 项目设置：AI代理可以创建新的
package.json文件中包含新项目的适当依赖关系和约定。
此存储库尚未解决的问题
虽然用于AI驱动的Next.js项目管理的MCP服务器提供了一套强大的工具来管理Next.js项目，但仍有一些领域需要改进：
- 自动依赖安装：服务器当前未安装软件包；它只维持
package.json。申请后，您需要手动运行包管理器。 - 高级会议管理：虽然服务器提供基本的约定管理，但自动约定执行和验证等更高级的功能仍在开发中。
- 与其他工具集成：该服务器旨在与Next.js项目配合使用，但与其他工具和框架的集成仍然有限。
贡献
我们欢迎社区的贡献！如果您想为AI驱动的Next.js项目管理的MCP服务器做出贡献，请按照以下步骤操作：
- 分叉存储库：在GitHub上创建存储库的分支。
- 创建要素分支：为您的功能或错误修复创建一个新分支。
- 进行更改：实施您的更改，并确保它们经过充分测试。
- 提交拉取请求：提交一个拉取请求，明确描述您的更改。
有关贡献的更多详细信息，请参阅 贡献.md 文件。
许可证
用于AI驱动的Next.js项目管理的MCP服务器根据Apache许可证2.0获得许可。有关更多信息，请参阅 许可证 文件。