Akashi MCP 服务器
使用说明（简要要点，便于快速落地）
-
项目简介
- Akashi 是一个基于 MCP 协议的服务端框架，提供对资源、工具、Prompt 的标准化管理与渲染能力，面向 LLM 客户端（如 Claude Code、Cursor、Windsurf 等）提供上下文和功能服务。
- 服务器核心围绕资源管理、工具注册与执行、以及 Prompt 渲染三大能力，同时通过 HTTP/API、MCP、以及前端仪表盘等入口暴露功能。
-
主要功能点
- 资源与数据访问：以统一存储（数据库）提供资源访问与查询能力。
- 工具注册与执行：定义可查询/执行的 Tools，LLM 客户端可通过 MCP 调用外部功能。
- Prompt 定义与渲染：系统内置并支持可自定义的 Prompt 模板，配合上下文渲染对话。
- MCP 服务端实现：通过 JSON-RPC 风格的 MCP 协议进行交互，支持为 LLM 客户端提供上下文与能力声明。
- 会话与审计：会话管理、权限、以及对决策过程的审计记录。
- 传输与客户端适配：支持多种传输协议（如 StdIO、SSE、WebSocket 等），方便在不同环境中对接 MCP 客户端。
- 安全与扩展性：集成 JWT/ApiKey 鉴权、RBAC、以及可插拔的插件点（嵌入式/企业扩展）。
-
安装步骤
- 准备基础依赖：Go 1.26+、PostgreSQL（18+）及 pgvector、TimescaleDB 等扩展（完成初始化脚本）。
- 构建服务端 (完整服务器):
- 通过仓库提供的构建方式，将源码编译为可执行二进制。
- 启动与运行:
- 以默认配置启动服务器；确保数据库连接字符串、JWT 密钥、以及可选的 Qdrant/OpenAI/Ollama 等嵌入提供者参数正确配置后运行。
- 本地试运行的可选本地栈：
- 使用 Docker Compose 搭建 TimescaleDB、Qdrant、Ollama 等环境后再启动 Akashi 服务器，便于快速试用 MCP 集成。
-
服务器配置（MCP 客户端连接信息）
- MCP 客户端需要对接的配置包含服务器名称、启动命令及参数。示例如下（以中文注释解释，非代码块、便于理解）：
- 配置示例（JSON）: { "server": { "name": "akashi", "command": "/path/to/akashi-binary", "args": [ "--port", "8080", "--config", "/path/to/akashi.env" ] } }
- 说明：
- server.name 指定 MCP 服务端在客户端配置中的标识名。
- server.command 指向服务端镜像或本地二进制的启动路径。
- server.args 是传给可执行程序的启动参数（可选，按实际部署调整）。
- 备注：具体的 MCP 客户端配置也可能有所差异，建议结合 Claude Code/Cursor/Windsurf 的 MCP 集成文档进行对接，在 Claude/Cursor/Windsurf 的 MCP 配置中使用服务端的实际启动命令路径与参数。
-
基本使用方法
- 启动与接入
- 启动 Akashi MCP 服务器后，使用 MCP 客户端配置对接该服务器，确保传输通道（如 StreamableHTTP、Stdio 等）匹配客户端能力。
- 进行资源/工具/Prompt 的创建、查询与调用
- 通过 MCP 的工具集合，注册需要对外暴露的 Tools，并在 LLM 的流程中通过 MCP 调用实现外部功能。
- 使用 MCP 提供的 Prompt 管理接口获取或渲染前/后缀模板，以便在对话中注入上下文信息。
- 实时协作与监控
- 如需监控与审计，使用服务的日志、审计记录与对冲突的可观测性指标，结合仪表盘查看整体健康状况。
- 启动与接入