Nablarch MCP Server

MCP搜索检索

提供方 kumagoro1202

搜索检索 未标注 OAuth 授权 社区 / 第三方 ClaudeCursorVS Code

Nablarch MCP Server是一个基于RAG(检索增强生成)技术的MCP协议服务器,专为AI编码工具提供Nablarch框架的深度知识支持。

一句话选型结论

按资料字段整理

Nablarch MCP Server 属于搜索检索类 MCP 服务器,传输方式未标注,OAuth 授权,可直接接入 Claude、Cursor、VS Code,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类搜索检索 传输方式未标注 鉴权OAuth 授权 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 10 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

搜索检索
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量10暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

RAGJava本地部署MCP协议AI编码辅助Java框架支持知识检索

安装与配置

未标注 OAuth 授权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 10 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
联网搜索取证

让模型查最新资料并给出出处。

资料聚合

把一个主题的网页、文档集中抓回来整理。

情报与竞品检索

按关键词持续检索行业动态和竞品信息。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 10 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude、Cursor、VS Code,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在搜索检索场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Nablarch MCP Server当前 10 未标注 未标注 无 2026-05-17
Brave Search 433812ff 2 未标注 未标注 无 2026-05-17
Sequentialthinking 1 SSE · 服务端推送 远程部署 有 2026-05-18
Baidu Netdisk 未标注 未标注 未标注 无 2026-05-17
ragflow 未标注 stdio · 本地进程 本地部署 有 2026-04-11
mindsdb (430e18) 未标注 未标注 未标注 有 2026-05-17

服务器档案

搜索检索
字段来自项目仓库与公开索引,中文说明由本站标注
提供方kumagoro1202上游标注的维护方 kumagoro1202
分类搜索检索本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

11.2 KB
来自项目仓库与上游目录的原文,未做删改

Nablacch MCP服务器

RAG强化型 模型上下文协议(MCP) 服务器。
纳布拉奇 将框架知识提供给AI编码工具。

概要

Nablarch是面向任务关键系统的Java应用程序框架,但与主流框架相比,社区资源明显不足。本MCP服务器 RAG(检索增强生成) 和 主控程序 结合,为AI工具提供Nablarch的深入知识。

| 检索增强生成 对Nablarch文档代码Javadoc的语义搜索
| 主控程序 将知识作为工具资源Prompts发布的标准协议
| 抹布+MCP 以高精度实现AI工具“知道并使用Nablarch的知识”

提供机能

  • 工具(10个):语义检索、手持编队设计、代码生成、设置XML验证、API检索、测试生成、故障排除、迁移分析、模式推荐、手持编队优化
  • 资源(8URI模式):处理程序目录、API参考、设计模式、学习指南、示例代码、设置模板、反模式、版本信息
  • 提示(6模板):手册队列设计(setup-handler-queue)、动作创建(create-action)、设置审阅(review-config)、处理程序解说(explain-handler)、迁移指南(migration-guide)、最佳实践(best-practices)
  • RAG管线:Nablarch官方文档GitHub113存储库Javadoc Fintan内容的混合搜索(BM25+向量相似度)

体系结构```

┌──────────────────────────────────────────────────────────────────┐
│ AIコーディングツール │
│ Claude Code | Cursor | Copilot | VS Code │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ MCP Client │ │
│ └──────────────────────────┬───────────────────────────────┘ │
└──────────────────────────────┼───────────────────────────────────┘
│ JSON-RPC 2.0
│ STDIO(ローカル)/ Streamable HTTP(リモート)
┌──────────────────────────────▼───────────────────────────────────┐
│ Nablarch MCP Server(Spring Boot) │
│ │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ MCP Protocol Layer │ │
│ │ Tools (10) | Resources (8種) | Prompts (6) │ │
│ └──────────────────────────┬──────────────────────────────────┘ │
│ │ │
│ ┌──────────────────────────▼──────────────────────────────────┐ │
│ │ RAGエンジン(内蔵) │ │
│ │ セマンティック検索 | ハイブリッド検索 | リランキング │ │
│ │ Doc Embedder (ONNX bge-m3) | Code Embedder (ONNX CodeSage) │ │
│ └──────────────────────────┬──────────────────────────────────┘ │
│ │ │
│ ┌──────────────────────────▼──────────────────────────────────┐ │
│ │ PostgreSQL + pgvector │ │
│ │ Docs Index | Code Index | Javadoc Index | Config │ │
│ └─────────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────────┘


## 动作要件

- Java 17 以上
- Maven 3.9.x(Maven Wrapper同梱)
- PostgreSQL 16+ with pgvector扩张(RAG机能、Phase 2以降)

## 快速启动

### 构建```bash
./mvnw package

知识库初始化(可选)

仅当使用嵌入式搜索时请在第一次运行一次。```bash

1. pgvectorコンテナ起動 + PostgreSQL初期化

docker compose up -d

2. Nablarch公式ドキュメントのEmbedding取込(所要時間: 約20-30分)

bash scripts/init-knowledge.sh


**処理内容:**

- 关闭Nablarch官方文档(467页)
- 区块分割(约1500区块)
- 在本地ONNX模型(BGE-M3)中生成嵌入式
- 存储在pgvector中

**注意:**

- `init-knowledge.sh` 而需要与环境混合的每条反射光线,进行环境采样**通过keyword mode(BM25检索)进行动作**做
- 嵌入式搜索很精确,但需要很长时间才能初始化
- 重新运行时,将覆盖现有数据(具有幂等性)

### 执行(STDIO模式)```bash
./mvnw spring-boot:run

在Claude Code中设置

MCP设置文件(.claude/mcp.json)中添加以下内容:```json
{
"mcpServers": {
"nablarch": {
"command": "java",
"args": ["-jar", "target/nablarch-mcp-server-0.1.0-SNAPSHOT.jar"]
}
}
}


### 在Docker上运行(Phase4)```bash
docker compose up

技术栈

|组件|技术|选择理由|
语言与Nablarch生态系统的一致性
框架|弹簧引导3.4.x|MCP引导器支持|
MCP-SDK · MCP Java SDK 0.17.x · 公式SDK、Spring AI统合
与Nablarch生态系统的完整性
标准Java测试
矢量DB矢量搜索集成,成本效率
|文档Embedding|BAAI/bge-m3(ONNX)/Jina v4(API fallback)|本地免费,可切换配置文件|
代码嵌入式(ONNX)/Voyage-code-3(API fallback)
重新排序:提高混合搜索精度
本地开发+远程团队共享

知识来源

RAG管线索引以下Nablarch相关信息源:

|来源|内容|规模|
| Nablarch官方文档 |体系结构、API规格、开发指南|数百页|
| GitHub nabarch组织 113存储库(源代码)|数万文件|
|Javadoc|所有API参考|所有模块|
| 芬拿 学习教材、开发标准|数十内容|

项目状态

现在:Phase1-3完成+Phase4-1(基于质量的可观察性)完成。Phase4-2〜4-4未着手。

实施情况摘要

| 实施阶段 Phase4-1完成(质量基础12任务)
| 工具 已安装、注册10个
| 资源 |8URI模式实施、注册完毕|
| 提示 实施了6个模板
| 测试 大于等于1027测试(0失败,14跳过=ONNX型号Phase1stub)
质量 · Checkstyle 0违反、SpotBugs 0件、CI/ CD导入済み
可观察性 · Actuator + 3 HealthIndicator +构造化ログ+相关ID + Micrometer/Prometheus
| 知识数据 17YAML文件(覆盖85%)
代理技能 · 6件(.claude/skills/配下)

Phase 1: MCP基盘+静的知识(✅ 完了)

  • [x]项目结构
  • [x] MCP SDK统合
  • x工具存根(search_api,validate_handler_queue)
  • [x]资源存根(API规格、处理程序规格)
  • [x] 知识库構造
  • [x] Tool実装(10个)
  • [x]资源实现(8URI模式)
  • [x]Prompt实施(6模板)
  • [x]MCP检验器测试

Phase2:RAG引擎集成(✅ 已完成

  • [x]pgvector设置+架构定义
  • 文档导入管线
  • [x]双嵌入式(可切换本地ONNX/AAPI)
  • [x] semantic_search 工具
  • [x]混合检索(BM25+矢量检索)
  • 重新排序
  • [x]検索质量评似

Phase3:工具扩充+代码生成(✅ 已完成

  • [x] design_handler_queue 工具(RAG协作)
  • [x] generate_code 工具(RAG协作)
  • [x] generate_test 工具
  • [x] troubleshoot 工具
  • [x] analyze_migration 工具
  • 可流HTTP传输
  • [x]所有Prompt模板

已实施质量改进(cmd_066)

P0改善(7件,支持拦截器):

  • DB认证信息的环境变量化(安全性)
  • 默认启用HTTP Origin验证(符合MCP规格MUST要求)
  • FQCN误り5件修正(情报精度向上)
  • version-info.yaml全面更新(最新环境情报反映)
  • Tool未登録2件追加(MigrationAnalysisTool,TestGenerationTool)
  • 资源提供者未登録6件追加(Api、模式、示例、配置、反模式、版本)
  • CI/CD導入(GitHub操作)

P1改善(7件、重要改善):

  • isError:true对应(MCP仕样准据)
  • 防止错误消息内部信息曝光
  • @ToolParam required=false添加(16个参数)
  • DesignHandlerQueueTool二重管理解消(约90行削减)
  • SetupHandlerQueuePrompt应用程序类型扩展(添加messaging模板)
  • 修正TroubleshootTool Markdown表类型
  • FQCN自动验证测试部署(增加131个测试用例)

知识数据扩充(cmd_078)

  • 知识YAML文件:10→17文件扩充(覆盖30%→85%)
  • 附加区域:数据绑定、验证、日志、邮件、消息、安全性和实用程序

Agent Skills导入(cmd_079)

  • .claude/skills/向下属添加6项代理技能
  • Nablarch API设计指南、组件XML设置指南、错误处理指南、手持编队设计指南、迁移指南、测试策略指南

Phase4-1:基于质量的可观察性(✅ 已完成

  • [x] 弹簧靴执行器(健康/信息/指标/普罗米修斯)
  • [x]3个自定义HealthIndicator+GracefulHealthStatusAggregator
  • [x]结构化日志(JSON)+请求相关标识
  • Counter/Timer/Error
  • [x] 普罗米修斯連携(/执行器/普罗米修斯)
  • [x]MCP JSON-RPC请求/响应日志
  • [x]错误处理统一+SpotBugs/Ceckstyle警告归零
  • 兼容pgvector集成测试CI
  • [x] Tool名snake_case统一

Phase 4-2〜4-4: 未着手

  • []Docker Compose部署(Phase4-2)
  • [ ] OAuth 2.0认证(Phase 4-3)
  • []自动更新管线/GitHub Webhook(Phase4-4)

已知问题

  • Phase4-2-4-4未着手(容器化、安全性、数据管线扩充)

文档

docs/INDEX.md -按读者列出的文档综合指南

|类别|内容|
导游/ · 🟢 面向用户 -设置、使用方法和可流HTTP设置
参考文献/ · 🔵 开发人员 —体系结构、API规范、RAG管线、DB架构
设计/ · 📐 设计书(Phase 1〜3、全23本)
文章/ · 📚 连载报道系列(全17报道的专家培养课程)
决策/ · 📋 ADR(架构决定记录)|
研究/ · 📊 调查报告、分析资料|

相关资源

  • MCP仕様
  • MCP Java SDK
  • 春季AI MCP
  • Nablarch官方文档
  • Nablach GitHub
  • pg向量

许可证

Apache许可证2.0

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Nablarch MCP Server 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Nablarch MCP Server 怎么在 Claude、Cursor、VS Code 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Nablarch MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Nablarch MCP Server 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Nablarch MCP Server 支持哪些客户端?

资料标注支持 Claude、Cursor、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Nablarch MCP Server 能提供哪些能力?

资料显示约 10 个工具;能力标签包括 RAG、Java、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。