Codestyle Server MCP【码蜂】
基于 Spring AI 的 MCP 服务器,为 IDE 和 AI 代理提供代码分析与代码模板搜索、检索工具。
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbriranalyzeProject(一站式分析,3~6 个关键词→位置+调用链+预览)、exploreCodeContext(expand / trace / search 读代码)codestyleSearch / getTemplateByPath / uploadTemplate / uploadTemplateFromFileSystem / deleteTemplateextractProjectSkeleton(AST 解析项目骨架)codestyle.tool-group 按需暴露工具,默认 all 暴露全部工具;若仅需代码分析可设为 analyze(2 工具),减少客户端 tokengroupId/artifactId/version/ Maven 风格目录git clone https://github.com/itxaiohanglover/mcp-codestyle-server.git
cd mcp-codestyle-server
mvn clean package -DskipTests
在 MCP 客户端(如 Cherry Studio、Cursor)中添加配置:
{
"mcpServers": {
"codestyle": {
"command": "java",
"args": [
"-Dspring.ai.mcp.server.stdio=true",
"-Dspring.main.web-application-type=none",
"-Dlogging.pattern.console=",
"-Dfile.encoding=UTF-8",
"-jar",
"/path/to/codestyle-server.jar"
]
}
}
}
默认 all 暴露全部工具;若仅需代码分析(2 工具)可加 -Dcodestyle.tool-group=analyze。
配置示例:
配置完成后,MCP 服务器会自动启动:
使用 codestyleSearch 工具搜索模板:
使用 getTemplateByPath 获取模板并生成代码:
点击安装按钮,系统会自动配置 MCP 服务器。
安装完成后,即可在对话中使用代码模板功能。
在对话中说:
帮我搜索 CRUD 模板
系统会调用 codestyleSearch 工具,返回匹配的模板列表和目录结构。
根据搜索结果,选择需要的模板路径,例如:
continew/CRUD/1.0.0/bankend/src/main/java/com/air/controller/Controller.ftl
系统会自动调用 getTemplateByPath 获取模板内容,并根据你的需求生成代码。
根据模板变量说明,提供必要的参数:
packageName: 包名(如:com.example.user)className: 类名(如:UserController)tableName: 表名(如:t_user)系统会自动填充模板并生成完整的代码。
repository:
# 本地缓存路径(可通过环境变量 CODESTYLE_CACHE_PATH 覆盖)
local-path: ${CODESTYLE_CACHE_PATH:./mcp-cache}
# 远程检索配置
remote:
# 是否启用远程检索(可通过环境变量 CODESTYLE_REMOTE_ENABLED 覆盖)
enabled: ${CODESTYLE_REMOTE_ENABLED:false}
# 远程服务地址(建议在配置文件中设置,不同环境使用不同的 application-{profile}.yml)
base-url: http://localhost:8000
# Access Key 和 Secret Key(建议在配置文件中设置,或使用配置中心)
access-key: ""
secret-key: ""
# 超时时间(毫秒)
timeout-ms: 10000
工具组(codestyle.tool-group,可选):
可通过 JVM 参数或环境变量覆盖:-Dcodestyle.tool-group=all 或 CODESTYLE_TOOL_GROUP=all。
骨架与图相关配置(codestyle.*,可选):
注意: 其他配置(base-url, access-key, secret-key, timeout-ms)建议在 application.yml 中直接配置,或使用 Spring Profile 管理不同环境的配置。
# 环境变量
export CODESTYLE_CACHE_PATH=/tmp/mcp-cache
export CODESTYLE_REMOTE_ENABLED=false
# application.yml(使用默认配置即可)
# 环境变量
export CODESTYLE_CACHE_PATH=/data/codestyle/mcp-cache
export CODESTYLE_REMOTE_ENABLED=true
# application-prod.yml
repository:
remote:
base-url: https://api.codestyle.top
access-key: your-production-ak
secret-key: your-production-sk
timeout-ms: 10000
# 启动命令
java -jar codestyle-server.jar --spring.profiles.active=prod
application.yml 或配置中心中配置一站式代码分析:传入项目路径与 3~6 个核心函数/类名(逗号分隔),一次返回 Summary、Call Flow、每个关键词的位置(file:startLine-endLine)、签名与代码预览;内部自动构建并缓存骨架,无需先调用 extractProjectSkeleton。适合 Cursor 等 AI 先全局理解再按需读代码。
输入:
- projectPath: 项目目录绝对路径
- keywords: 3~6 个核心函数/类名,逗号分隔(如: aquery_llm, kg_query, insert)
- focusPath: 可选,聚焦子目录(如 src/main)
输出: Markdown 报告(项目概览、Call Flow、每关键词位置+预览);增量调用时若关键词已缓存则返回精简摘要,建议用 exploreCodeContext(expand) 读代码
基于 analyzeProject 已缓存的骨架与依赖图,按意图精准读取代码。支持 expand(按文件/行范围批量读代码,支持 file1:start-end|file2:start-end,单次批量 12K 字符按目标数均分)、trace(上下游调用链)、search(按名称搜索)。
输入:
- projectPath: 项目目录绝对路径(analyzeProject 会自动缓存骨架)
- mode: expand / trace / search
- query: 文件路径、类名、方法名或关键词;expand 支持 | 分隔批量
- direction: trace 时 upstream / downstream / both(默认 both)
- maxDepth: 最大遍历深度(默认 3)
- lineRange: expand 时可选行范围,如 100-200(1 基,含端点)
输出: 展开的代码片段 / 调用链 / 搜索结果
推荐工作流:先 analyzeProject(projectPath, keywords) → 从报告取 file:start-end → exploreCodeContext(mode=expand, query="file:start-end|...") 批量读代码;理解调用关系时用 mode=trace, query="函数名"。
template 或 all)搜索模板,返回目录树 + 描述。
输入: templateKeyword (如: CRUD, continew/CRUD)
输出:
找到模板组: CRUD
目录树:
└── continew/CRUD/1.0.0/
└── src/main/java/.../Controller.ftl
模板组介绍: ...
获取模板内容,返回变量说明 + 代码。
输入: templatePath (如: continew/CRUD/1.0.0/.../Controller.ftl)
输出:
#文件名:...
#文件变量:
- className: 类名(示例:UserController)[String]
#文件内容:
package ${packageName};
...
上传模板到本地仓库或远程服务器。
输入:
- templatePath: 模板路径(groupId/artifactId/version)
- overwrite: 是否覆盖(可选,默认 false)
本地模式输出:
✓ 模板已保存到本地
- 路径: ~/.codestyle/cache/groupId/artifactId/version
- 文件数: 5
- 索引已更新
远程模式输出:
✓ 模板已上传
- 本地路径: ~/.codestyle/cache/groupId/artifactId/version
- 远程 ID: groupId/artifactId/version
- 文件数: 5
- 索引已更新
从文件系统上传模板到本地仓库或远程服务器。
输入:
- sourcePath: 文件系统路径(如: /path/to/template)
- groupId: 组ID(如: mygroup)
- artifactId: 项目ID(如: MyTemplate)
- version: 版本号(如: 1.0.0)
- overwrite: 是否覆盖(可选,默认 false)
输出:
✓ 模板已保存到本地
- 源路径: /path/to/template
- 本地路径: ~/.codestyle/cache/mygroup/MyTemplate/1.0.0
- 文件数: 3
- 索引已更新
code-analysis 或 all)对指定项目目录执行多语言 AST 深度解析,构建层级代码树 (HCT) 与多类型依赖图 (MDG),以 Markdown+XML 混合格式返回精简骨架。支持 Java、Python、JavaScript、TypeScript、Go。在默认组 all 下会暴露;若仅需代码分析可设 codestyle.tool-group=analyze,则不含本工具。
输入:
- projectPath: 项目目录绝对路径
- detailLevel: 1=目录概览, 2=类骨架(推荐), 3=方法签名+docstring, 4=完整
- focusPath: 可选,聚焦子目录(如 src/main),仅解析该目录
输出: Markdown + <directory_tree> / <ast_skeleton> / <dependency_graph> 混合文档
删除指定版本的模板。
输入: templatePath (如: groupId/artifactId/version)
本地模式输出:
✓ 模板已删除
- 路径: groupId/artifactId/version
- 索引已更新
远程模式输出:
✓ 模板已删除
- 本地路径: groupId/artifactId/version
- 远程 ID: groupId/artifactId/version
- 索引已更新
mcp-cache/
├── lucene-index/ # Lucene 索引
└── {groupId}/{artifactId}/
└── {version}/ # 版本目录
├── meta.json # 元数据(单版本格式)
├── README.md # 模板描述
└── .../*.ftl # 模板文件
{
"groupId": "continew",
"artifactId": "CRUD",
"version": "1.0.0",
"name": "CRUD",
"description": "CRUD 代码生成模板",
"files": [{
"filePath": "/bankend/src/main/java/com/air/controller",
"filename": "Controller.ftl",
"description": "控制层类模板",
"sha256": "...",
"inputVariables": [...]
}]
}
格式说明:
groupId/artifactId/version/ 结构Q: "本地缓存路径未配置"
A: 请设置 repository.local-path 或环境变量 CODESTYLE_CACHE_PATH
Q: "远程检索已启用,但未配置 access-key"
A: 请在 CodeStyle 管理后台创建 Open API 应用获取 AK/SK,然后在 application.yml 中配置
Q: 签名验证失败
A: 请检查 AK/SK 是否正确,应用是否已启用且未过期
Q: 请求超时
A: 请检查网络连接,或增加 timeout-ms 配置
Q: 远程检索失败
A: 系统会自动降级到本地 Lucene 检索
all 全量验证;若仅测代码分析可加 -Dcodestyle.tool-group=analyzeskill/codestyle/ 下提供 SKILL.md 与 references,可用于代码审查与 Skill 可用性校验(参见 Issue #26)代码分析增强:
codestyle.tool-group=all 暴露全部工具;可选 analyze 仅暴露 analyzeProject + exploreCodeContext,减少 tools/list 体积与 token配置与文档:
CODESTYLE_TOOL_GROUP 环境变量与 codestyle.tool-group 配置新增功能:
upload 和 delete 命令技术改进:
uploadTemplate 和 deleteTemplate MCP 工具uploadTemplateFromFileSystem 工具(支持文件系统路径)使用示例:
# 从文件系统上传
java -jar codestyle-server.jar upload --path /path/to/template --group mygroup --artifact MyTemplate --version 1.0.0
# 从仓库路径上传
java -jar codestyle-server.jar upload --path mygroup/MyTemplate/1.0.0 --overwrite
# 删除模板
java -jar codestyle-server.jar delete mygroup/MyTemplate/1.0.0
重大更新:
技术改进:
破坏性变更:
groupId/artifactId/ 移至 groupId/artifactId/version/核心功能:
MCP Codestyle Server 是一个基于 Spring AI 实现的 Model Context Protocol (MCP) 服务器,为 IDE 和 AI 代理提供代码模板搜索和检索工具。该服务从本地缓存查找模板,并在缺失时自动从远程仓库下载元数据和文件进行修复。
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
MCP Codestyle Server roda localmente via stdio.
Última verificação: 2026-10-27. MCP Codestyle Server 是一个基于 Spring AI 实现的 Model Context Protocol (MCP) 服务器,为 IDE 和 AI 代理提供代码模板搜索和检索工具。该服务从本地缓存查找模板,并在缺失时自动从远程仓库下载元数据和文件进行修复。