Codestyle Server MCP【码蜂】
基于 Spring AI 的 MCP 服务器,为 IDE 和 AI 代理提供代码分析与代码模板搜索、检索工具。
Power your agent
पब्लिशर का इंस्टॉल। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
रजिस्ट्री में अभी कोई पैकेज्ड रिलीज़ नहीं है। रिपॉज़िटरी का README देखें.
रिमोट URL या आपकी मशीन पर कमांड? दोनों इंस्टॉल में क्या अंतर है
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.
लॉन्चanalyzeProject(一站式分析,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 代理提供代码模板搜索和检索工具。该服务从本地缓存查找模板,并在缺失时自动从远程仓库下载元数据和文件进行修复。
टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
MCP Codestyle Server stdio पर लोकल चलता है।
पिछली जाँच 2026-10-27 को हुई। MCP Codestyle Server 是一个基于 Spring AI 实现的 Model Context Protocol (MCP) 服务器,为 IDE 和 AI 代理提供代码模板搜索和检索工具。该服务从本地缓存查找模板,并在缺失时自动从远程仓库下载元数据和文件进行修复。