Konkin MCP 服务端

关键词

AI上下文服务资源管理工具执行JSON-RPC安全会话

使用说明内容（Markdown格式）

  • 项目简介

    • Konkin 是一个完整的 MCP 风格后端实现，提供资源访问、工具执行和与 LLM 交互所需的上下文信息。服务器通过 JSON-RPC/类似消息协议与 MCP 客户端通信，支持多种传输方式（如 SSE、Stdio、WebSocket），并包含会话管理、认证与多币种钱包集成等功能。

  • 主要功能点

    • 资源与数据访问：后端持有并暴露资源，支持 LLM 客户端读取内容。
    • 工具注册与执行：LLM 可以通过 MCP 调用服务器注册的工具，执行外部功能。
    • Prompt 模板/交互配置：提供可定制的交互模板与渲染能力，用于定义 LLM 的对话场景。
    • 会话与认证：包含会话管理、REST API 授权、以及对 Landing 页/密码保护等安全特性。
    • 多传输协议：支持 SSE、WebSocket、标准 I/O 等传输，方便不同客户端接入。
    • 服务器端可扩展性：结构化的钱包/币种支持、MCP 驱动、以及插件式的工具和资源管理。
    • 端到端示例与集成测试：提供大量的集成测试，涵盖 MCP 资源、工具、身份验证、历史记录等场景。

  • 安装步骤

    • 需要 Java 17+（仓库中用到的 Java 相关技术栈）。
    • 使用 Maven 构建并打包：mvn clean install。
    • 运行服务器：java -jar target/konkin-server-<版本>-SNAPSHOT.jar config.toml。首次启动时会在 ./secrets/ 目录自动生成密钥/凭据并输出到控制台，务必记录并妥善保存。
    • 配置文件：编辑工作目录下的 config.toml，按仓库示例配置服务器地址、代理人、币种等信息。

  • 服务器配置（给 MCP 客户端的连接信息，客户端无需改动） 说明：MCP 客户端需要知道服务器的名称、执行命令及参数以连接并通过传输通道访问 MCP 服务。以下为示例配置描述，实际需结合运行环境调整。 { "serverName": "konkin", "command": "java", "args": ["-jar", "konkin-server-<version>.jar", "config.toml"], "transport": ["sse", "stdio", "websocket"], "notes": "稳定运行依赖于正确的配置 toml，并确保 secrets 文件就绪。MCP 客户端通过指定 serverName、transport 与协议即可与服务端建立连接。" }

  • 基本使用方法

    • 启动后访问健康接口和 MCP 接入端点，验证服务器是否正常工作。
    • 使用 MCP 客户端通过指定传输通道（如 SSE）与服务端建立会话，读取资源、执行工具、获取并渲染 Prompt 模板。
    • 若需要对接 Claude、其它大模型或自定义代理，请参阅仓库中测试用例与集成示例，了解如何通过 MCP 与服务端交互。
    • 安全与运维：关注日志配置、秘密文件的生成与轮换、以及健康检查接口，确保生产环境的稳定性。

服务器信息

访问项目