Jeesty MCP
用于AI助手的MCP服务器
一个提供MCP（模型上下文协议）服务器的npm包，让GitHub Copilot和Claude等AI助手可以访问工作空间工具。
快速开始
npx jeesty-mcp init这将创建：
.jeestymcp/config.json--工具、提示和资源定义.jeestymcp/instructions.md--项目的AI指令模板- 将jeesty mcp添加到您的VS代码mcp配置中
重新加载VS代码以开始使用MCP服务器。
配置位置
这 init 命令可以将jeesty mcp添加到两个不同的位置：
# User-level config (default) - applies to ALL your projects
npx jeesty-mcp init
# Workspace-level config - only for this project
npx jeesty-mcp init --workspace| 配置级别 | 位置 | 范围 |
|---|---|---|
| 用户 | ~/.vscode/mcp.json | 所有VS代码工作区 |
| 工作区 | .vscode/mcp.json | 只是这个项目 |
优先：工作区配置始终覆盖用户配置。如果你想让一个项目使用不同的MCP服务器设置（例如，用于开发），这很有用。
项目配置
你的项目 .jeestymcp/ 文件夹包含：
| 文件 | 目的 |
|---|---|
config.json | 定义自定义工具、提示和资源 |
instructions.md | AI指令模板（使用胡子变量） |
config.json示例
{
"tools": {
"deploy": {
"usage": "Deploy the application to production",
"cmd": "npm run deploy",
"params": {
"environment": {
"type": "string",
"description": "Target environment (staging/production)",
"required": true
}
}
},
"webget": {
"usage": "Fetch content from a URL",
"module": "scripts/webget.js",
"params": {
"url": { "type": "string", "description": "The URL to fetch", "required": true }
}
}
},
"prompts": {
"explain-code": {
"description": "Explain code in plain English",
"template": "Please explain the following code:\n\n{{code}}"
}
},
"resources": {
"myapp://status": {
"description": "Get app status",
"url": "http://localhost:3000/status",
"mimeType": "application/json"
}
}
}内置工具
| 工具 | 说明 |
|---|---|
pingJeestyMCP | 验证MCP服务器是否正在运行 |
自定义工具
工具可以在两种模式下执行：
命令模式(cmd)：生成一个shell并运行命令
{
"usage": "Run tests",
"cmd": "npm test",
"params": { ... }
}模块模式(module)：导入一个JS/TS模块并调用其 run() 函数
{
"usage": "Fetch a URL",
"module": "scripts/webget.js",
"params": { ... }
}模块模式更快（没有shell开销），可以返回结构化数据。该模块必须导出：
export async function run(params: Record): Promise刀具参数
参数支持以下选项：
type:"string","number","boolean"description：向AI显示帮助文本required：参数是否为必填项addToCmdWithoutKey：如果为true，则值作为位置arg传递，而不是--key=value
CLI命令
npx jeesty-mcp init # Add to user MCP config + create .jeestymcp/
npx jeesty-mcp init --workspace # Add to workspace .vscode/mcp.json instead
npx jeesty-mcp remove # Remove from user MCP config
npx jeesty-mcp --help # Show help运作原理
- VS Code启动jeesty mcp服务器（通过mcp配置）
- 服务器从您的工作区向上搜索
.jeestymcp/config.json - AI助手可以调用提供的工具与您的工作空间进行交互
- 自定义工具执行shell命令或进程内模块并返回输出
发展
如果你正在开发jeesty mcp本身：
使用Nodemon自动重启
配置您的 工作区 .vscode/mcp.json 要使用具有自动重启功能的本地构建，请执行以下操作：
{
"servers": {
"jeesty-mcp": {
"type": "stdio",
"command": "npx",
"args": ["nodemon", "--watch", "out", "--ext", "js", "--exec", "node", "${workspaceFolder}/out/mcp-server/index.js"],
"env": {
"JEESTY_WORKSPACE_PATH": "${workspaceFolder}"
}
}
}
}此工作区配置覆盖了用户级配置，因此您的开发环境使用本地构建，而其他项目使用已发布的npm包。
开发配置文件
repo使用遗留配置文件名进行开发（未发布到npm）：
jm-config.json--dev配置jm-instructions.md--开发指令模板
MCP服务器在以下情况下检查这些作为回退 .jeestymcp/config.json.
许可证
麻省理工学院