使用说明
JYMP MCP服务器
🔗 MCP服务器，将您的代码库文件组合到一个AI助手提示中
将任何目录转换为AI就绪的代码库提示。适用于Perplexity、Claude Desktop和任何兼容MCP的客户端。
[！[npm版本](https://img.shields.io/npm/v/@马亨德拉189/j [！[许可证：MIT]（https：//***
📦 安装
npm install -g @mahendra189/jymp-mcp-server
查找安装路径：
which jymp-mcp-server
复制此路径-您将需要它进行以下设置。
输出示例：
- macOS（NVM）：
/Users/yourusername/.nvm/versions/node/v22.10.0/bin/jymp-mcp-server - macOS（Homebrew）：
/opt/homebrew/bin/jymp-mcp-server - 窗户：
C:\Users\yourusername\AppData\Roaming\npm\jymp-mcp-server.cmd
🚀 困惑设置（Mac）
- 打开 困惑Mac应用程序
- 首选 设置→ 连接器
- 安装 困惑XPC助手 （如果尚未安装）
- 点击 “添加连接器”
- 输入：
服务器名称：
JYMP Codebase Tool
命令： （使用您的路径从 which jymp-mcp-server)
/Users/yourusername/.nvm/versions/node/v22.10.0/bin/jymp-mcp-server
- 点击 保存
- 等待状态显示 “跑步” （绿色）
用法
- 转到困惑主页
- 在...之下 “来源” 在底部，切换 JYMP 开
- 尝试以下提示：
List all files in /Users/yourusername/my-project
Create a codebase prompt for /Users/yourusername/my-project
Combine these files: src/index.ts, src/utils.ts from /Users/yourusername/my-project
🖥️ Claude桌面设置
macOS
- 查找您的安装路径：
which jymp-mcp-server
- 打开配置文件：
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
- 添加（替换为步骤1中的路径）：
{
"mcpServers": {
"jymp": {
"command": "/Users/yourusername/.nvm/versions/node/v22.10.0/bin/jymp-mcp-server"
}
}
}
-
完全退出并重新启动Claude Desktop
-
寻找 🔨 锤图标 验证连接
视窗
- 查找您的安装路径：
where jymp-mcp-server
- 打开配置文件：
notepad %APPDATA%\Claude\claude_desktop_config.json
- 添加（使用双反斜杠）：
{
"mcpServers": {
"jymp": {
"command": "C:\\Users\\yourusername\\AppData\\Roaming\\npm\\jymp-mcp-server.cmd"
}
}
}
- 重新启动克劳德桌面
📚 可用工具
1. get_codebase_files
列出目录中的所有文件（方面 .jympignore)
例子：
"List all files in /Users/me/my-app"
2. create_codebase_prompt
将所有文件合并到一个LLM提示符中
例子：
"Create a codebase prompt for /Users/me/my-app with basic compression"
参数：
directory：项目路径compression:none或basic（可选）
3. create_prompt_from_files
将特定文件合并到提示中
例子：
"Combine src/index.ts and src/utils.ts from /Users/me/my-app"
参数：
directory：基本目录路径files：文件路径数组compression:none或basic（可选）
⚙️ 配置
使用.jympignore排除文件
创建一个 .jympignore 项目根目录中的文件：
node_modules
.git
dist
build
.env
*.log
.DS_Store
coverage/
服务器会自动遵守这些排除。
压缩模式
none（默认）：完整文件内容basic：删除注释、空行并压缩空白
🔧 故障排除
安装后“找不到命令：jymp-mcp-server”
问题： npm全局bin目录不在PATH中
解决方案：
# Add npm global bin to your PATH
echo 'export PATH="$(npm bin -g):$PATH"' >> ~/.zshrc
source ~/.zshrc
# Then reinstall
npm install -g @mahendra189/jymp-mcp-server
# Find the path
which jymp-mcp-server
困惑中的“服务器未运行”
解决：
- 确保你使用了 完整路径 从
which jymp-mcp-server - 首先在终端中测试命令：
/your/full/path/to/jymp-mcp-server
- 尝试删除并重新添加连接器
- 仔细检查您是否正确复制了路径（无拼写错误）
Claude Desktop中的“无法连接”
解决：
- 完全退出 克劳德桌面（Cmd+Q，不仅仅是关闭窗口）
- 验证您使用了正确的完整路径
which jymp-mcp-server - 首先在终端进行测试，以确保其正常工作
- 检查配置文件中的拼写错误
- 确保JSON语法正确（逗号、引号等）
macOS上的权限错误
Claude可能需要磁盘访问权限：
- 首选 系统设置→ 隐私和安全→ 文件和文件夹
- 授予Claude访问要扫描的目录的权限
还有问题吗？
运行以下诊断命令：
# Check Node.js is installed
node --version
# Check npm is working
npm --version
# List global packages
npm list -g --depth=0
# Find jymp-mcp-server path
which jymp-mcp-server
# Test it directly
$(which jymp-mcp-server)
如果最后一个命令有效，则使用Perplexity/Claude配置中的确切路径。
📖 示例用例
代码审查
"Create a codebase prompt for /Users/me/pull-request-branch"
在一个提示中获取所有更改的文件，以便使用AI进行审核
文档
"List all files in /Users/me/project/docs"
查看您的文档结构
调试
"Combine src/bug.ts and tests/bug.test.ts from /Users/me/project"
获取AI调试的相关代码
入职
"Create a codebase prompt for /Users/me/new-project with basic compression"
获取新代码库的压缩概览
🗑️ 卸载
npm uninstall -g @mahendra189/jymp-mcp-server
🐛 报告问题
发现bug了吗？有功能请求吗？
github：https://github.com/mahendra189/jymp-mcp-server/issues
📄 许可证
麻省 理工© 马亨德拉 库马尔
🔗 相关项目
由以下材料制成❤️ 作者：马亨德拉库马尔
