Rag Demo

MCPAI代理

提供方 jaflaten

AI代理 未标注 无需鉴权 社区 / 第三方 Claude DesktopClaude

一个基于Kotlin MCP SDK实现的模型上下文协议(MCP)服务器,提供LLM上下文管理和RAG管道功能。

一句话选型结论

按资料字段整理

Rag Demo 属于AI代理类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

Kotlin本地部署LLM上下文管理RAG系统Kotlin开发模型协议AI服务

安装与配置

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

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

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

值得选的地方

  • 资料标注 2 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Rag Demo当前 2 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

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

详细介绍

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

MCP服务器演示-Hello World

一个简单的“Hello World”模型上下文协议(MCP)服务器实现,使用 Kotlin MCP SDK.

什么是MCP?

模型上下文协议(MCP)是一种标准化的协议,允许应用程序以一致的方式为大型语言模型(LLM)提供上下文。它将提供上下文的关注点与实际的LLM交互分开,实现了更好的模块化和可重用性。

项目概述

该项目展示了:

MCP服务器功能

  • 2工具:hello(问候),echo(消息重复)
  • 2资源:服务器信息,动态问候语
  • 输入消毒:防止注射攻击

RAG管道(新!)

一个完整的检索增强生成系统,包括:

  • 文件摄入:读取和解析Markdown/文本文件
  • 智能分块:句子意识分裂与重叠
  • 矢量嵌入:OpenAI文本嵌入3-small
  • 矢量存储器:具有JSON持久性的内存数据库

看 RAG_README.md 获取完整的RAG文档。

先决条件

  • Java 17或更高版本
  • Gradle(包装内含)

建设项目```bash

./gradlew clean build


## 运行服务器

您可以在两种模式下运行MCP服务器:

### 1.标准模式(适用于克劳德桌面、MCP检查器)

服务器使用STDIO传输与MCP客户端通信:```bash
./gradlew run

或者运行编译后的JAR:```bash
java -jar build/libs/mcp-server-demo-0.0.1-all.jar


### 2.HTTP模式(用于Web应用程序、API)

在端口8080上作为HTTP服务器运行:```bash
./gradlew runHttpServer

然后通过HTTP访问:```bash

Health check

curl http://localhost:8080/health

Call a tool

curl -X POST -H "Content-Type: application/json" \
-d '{"tool":"rag_query","arguments":{"query":"What type is Lapras?"}}' \
http://localhost:8080/mcp/call


看 HTTP_MCP_SERVER.md 获取完整的HTTP API文档。

## 可用工具

### 1.你好

用可选的个性化消息问候用户。

**参数:**

- `name` (可选):要问候的人的姓名

**示例:**

- 无名称:返回“Hello,World!欢迎使用MCP Hello World服务器!”
- 使用name:返回“Hello,\[name\]!欢迎使用MCP Hello World服务器!”

### 2.回声

回应您提供的信息。

**参数:**

- `message` (必填):要回显的消息

**例子:**

- 输入:“测试消息”
- 输出:“回声:测试消息”

## 可用资源

### 1.服务器信息

提供服务器信息的静态资源。

**URI:** `hello://server/info`\
**类型:** 文本/纯文本\
**内容:** 服务器版本、功能和描述

### 2.个性化问候

生成个性化问候消息的动态资源。

**URI模式:** `hello://greetings/{name}`\
**类型:** 文本/纯文本\
**URI示例:**

- `hello://greetings/Alice` -问候爱丽丝
- `hello://greetings/Bob` -问候Bob

**内容:** 带有时间戳的个性化问候

## 项目结构```
.
├── build.gradle.kts              # Gradle build configuration
├── src/
│   └── main/
│       └── kotlin/
│           └── HelloWorldMcpServer.kt  # Main MCP server implementation
└── README.md                      # This file

关键组件

服务器设置

服务器配置了:

  • 名字:hello world服务器
  • 版本: 1.0.0
  • 能力:
  • 支持列表更改通知的工具
  • 资源(静态和动态)
  • 运输:STDIO(标准输入/输出)
  • 安全:输入净化和验证(参见 安全.md)

代码亮点```kotlin

// Creating the server
val server = Server(
serverInfo = Implementation(
name = "hello-world-server",
version = "1.0.0"
),
options = ServerOptions(
capabilities = ServerCapabilities(
tools = ServerCapabilities.Tools(listChanged = true)
)
)
) {
"A simple Hello World MCP server demonstrating tool capabilities"
}

// Adding a tool
server.addTool(
name = "hello",
description = "Returns a friendly greeting message...",
inputSchema = Tool.Input(
properties = buildJsonObject {
putJsonObject("name") {
put("type", "string")
put("description", "The name of the person to greet (optional)")
}
},
required = emptyList()
)
) { request ->
// Tool implementation
}


## 依赖项

- **Kotlin MCP SDK** (0.7.7):核心MCP协议实现
- **哪个**:HTTP客户端和服务器框架
- **Kotlinx IO**:Kotlin的现代IO原语
- **Kotlinx序列化**:JSON处理

## 安全

此服务器实现了输入净化,以防止常见漏洞:

- 控制字符过滤(换行符、制表符等)
- 防止DoS攻击的长度限制
- 空白修剪
- 消毒后验证

有关详细信息,请参阅 安全.md.

## 使用MCP客户端进行测试

要测试此服务器,您需要一个MCP客户端。你可以:

1. 使用 MCP官方检查员
1. 使用MCP Kotlin SDK构建自定义客户端
1. 与支持MCP的LLM应用程序集成(如Claude Desktop)

## 更多资源

- MCP官方文件
- Kotlin MCP SDK库
- MCP规范

## 许可证

这个项目是开源的,可以在MIT许可证下使用。

此项目是使用创建的 Ktor项目生成器.

以下是一些帮助您入门的有用链接:

- Ktor文件
- Ktor GitHub页面
- 这 Ktor Slack聊天你需要
到 请求邀请 加入。

## 特性

以下是此项目中包含的功能列表:

|名称|描述|
|----------------------------------------------------|-------------------------------------------------------------|
| 路由 |允许定义结构化路由和相关处理程序。 |

## 建筑与运营

要构建或运行项目,请使用以下任务之一:

|任务|描述|
|-----------------------------------------|----------------------------------------------------------------------|
| `./gradlew test` |运行测试|
| `./gradlew build` |构建一切|
| `./gradlew buildFatJar` |构建包含所有依赖项的服务器的可执行JAR|
| `./gradlew buildImage` |构建docker镜像以与胖JAR一起使用|
| `./gradlew publishImageToLocalRegistry` |在本地发布docker镜像|
| `./gradlew run` |运行服务器|
| `./gradlew runDocker` |使用本地docker镜像运行|

如果服务器成功启动,您将看到以下输出:```
2024-12-04 14:32:45.584 [main] INFO  Application - Application started in 0.303 seconds.
2024-12-04 14:32:45.682 [main] INFO  Application - Responding at http://0.0.0.0:8080

常见问题

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

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

Rag Demo 怎么在 Claude Desktop、Claude 里配置?

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

Rag Demo 收费吗?

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

Rag Demo 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Rag Demo 支持哪些客户端?

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

Rag Demo 能提供哪些能力?

资料显示约 2 个工具;能力标签包括 Kotlin、AI服务、Claude。具体工具清单以官方文档为准。

热门专题

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

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