项目介绍
Shinkuro - 通用提示加载器 MCP 服务器
从本地文件夹或Git仓库加载Markdown文件，并作为MCP 提示提供服务。
适用于从各种来源和格式加载提示到您的MCP应用程序中，并在组织之间共享提示。
<!-- 等待许可证问题修复 --> <!-- <a href="https://glama.ai/mcp/servers/@DiscreteTom/shinkuro"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@DiscreteTom/shinkuro/badge" alt="Shinkuro MCP 服务器" /> </a> -->使用方法
重要：确保您的MCP客户端支持MCP提示功能。参见功能支持矩阵。
完整CLI用法
<details> <summary><code>uvx shinkuro --help</code></summary> 使用: shinkuro [选项]
Shinkuro - 通用提示加载器 MCP 服务器
╭─ 选项 ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --folder 文本 包含Markdown文件的本地文件夹路径，或Git仓库中的子文件夹 [环境变量: FOLDER] │
│ --git-url 文本 Git仓库URL（支持GitHub、GitLab、SSH、带有凭证的HTTPS） [环境变量: GIT_URL] │
│ --cache-dir 文本 缓存远程仓库的目录 [环境变量: CACHE_DIR] [默认值: ~/.shinkuro/remote] │
│ --auto-pull 是否在启动时刷新本地缓存 [环境变量: AUTO_PULL] │
│ --variable-format [brace|dollar] 模板变量格式 [环境变量: VARIABLE_FORMAT] [默认值: brace] │
│ --auto-discover-args 自动发现模板变量作为所需参数 [环境变量: AUTO_DISCOVER_ARGS] │
│ --skip-frontmatter 跳过前言处理并使用原始Markdown内容 [环境变量: SKIP_FRONTMATTER] │
│ --version 显示版本并退出 │
│ --help 显示此消息并退出。 │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
本地文件
添加到您的MCP客户端配置：
{
"mcpServers": {
"shinkuro": {
"command": "uvx",
"args": ["shinkuro"],
"env": {
"FOLDER": "/path/to/prompts"
}
}
}
}
远程Git仓库
添加到您的MCP客户端配置：
{
"mcpServers": {
"shinkuro": {
"command": "uvx",
"args": ["shinkuro"],
"env": {
"GIT_URL": "https://github.com/owner/repo.git",
"FOLDER": "prompts" // 可选，Git仓库中的子文件夹
}
}
}
}
这会将仓库克隆到本地缓存目录。请确保您有正确的权限。
支持私有仓库，例如
"GIT_URL": "git@github.com:DiscreteTom/shinkuro.git"（使用SSH密钥），"GIT_URL": "https://<username>:<PAT>@github.com/owner/repo.git"（使用个人访问令牌）
与Spec-Kit一起使用
<details> <summary>展开</summary>首先，将spec-kit提示移动到./.shinkuro/prompts文件夹。
然后添加到您的MCP客户端配置：
{
"mcpServers": {
"shinkuro": {
"command": "uvx",
"args": ["shinkuro"],
"env": {
"FOLDER": "./.shinkuro/prompts",
"VARIABLE_FORMAT": "dollar",
"AUTO_DISCOVER_ARGS": "true",
"SKIP_FRONTMATTER": "true"
}
}
}
}
这将公开spec-kit指令作为MCP提示。
</details>提示加载
指定文件夹中的每个Markdown文件（包括嵌套文件夹）都将被加载为一个提示。
示例文件夹结构：
my-prompts/
├── think.md
└── dev/
├── code-review.md
└── commit.md
上述示例将加载为3个提示：think，code-review 和 commit。
示例提示文件
最简单的
使用常规提交方式提交到git。
带元数据的提示
---
name: "code-review" # 可选，默认为文件名
title: "代码审查助手" # 可选，默认为文件名
description: "" # 可选，默认为文件路径
---
# 代码审查
请检查这段代码的最佳实践和潜在问题。
带参数的提示
---
name: "greeting"
description: "生成个性化的问候信息"
arguments:
- name: "user"
description: "用户的姓名"
# 没有默认值 = 必填参数
- name: "project"
description: "项目名称"
default: "MyApp"
---
说：你好 {user}！欢迎来到 {project}。希望您在这里过得愉快！
像 {user} 和 {project} 这样的变量将在检索提示时被实际值替换。
使用 {{var}}（双括号）来转义并显示实际的括号，当使用花括号格式化程序时。
不同的变量格式：
brace（默认）：{user}，{project}dollar：$user，$project