【技术文档摘要】

JYMP MCP Server

<img src="https://raw.githubusercontent.com/mahendra189/jymp/refs/heads/main/assets/logo.png" alt="JYMP Logo" width="80" height="80" /> <img src="https://gips3.baidu.com/it/u=362385629,2715447005&fm=3081&app=3081&f=JPEG?w=630&h=630" alt="JYMP Logo" width="80" height="80" />

🔗 将你的代码库文件合并成一个AI助手提示的MCP服务器

将任何目录转换为AI可用的代码库提示。适用于Perplexity、Claude Desktop以及任何兼容MCP的客户端。

[] []

📦 安装

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
• Windows: C:\Users\yourusername\AppData\Roaming\npm\jymp-mcp-server.cmd

---

🚀 Perplexity 设置（Mac）

1. 打开 Perplexity Mac 应用
2. 前往 设置 → 连接器
3. 安装 PerplexityXPC 辅助程序（如果尚未安装）
4. 点击 “添加连接器”
5. 输入：

服务器名称：

JYMP 代码库工具

命令：（使用来自 which jymp-mcp-server 的您的路径）

/Users/yourusername/.nvm/versions/node/v22.10.0/bin/jymp-mcp-server

6. 点击 保存
7. 等待状态显示 “运行中”（绿色）

使用方法

1. 转到 Perplexity 首页
2. 在底部的 “来源” 下，切换 JYMP 开启
3. 尝试这些提示：

列出 /Users/yourusername/my-project 中的所有文件

为 /Users/yourusername/my-project 创建一个代码库提示

组合这些文件：src/index.ts, src/utils.ts 从 /Users/yourusername/my-project

---

🖥️ Claude Desktop 设置

macOS

1. 查找您的安装路径：

which jymp-mcp-server

2. 打开配置文件：

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

3. 添加（替换为步骤1中的您的路径）：

{
  "mcpServers": {
    "jymp": {
      "command": "/Users/yourusername/.nvm/versions/node/v22.10.0/bin/jymp-mcp-server"
    }
  }
}

4. 完全退出并重新启动 Claude Desktop

5. 查看 🔨 锤子图标 来验证连接

Windows

1. 查找您的安装路径：

where jymp-mcp-server

2. 打开配置文件：

notepad %APPDATA%\Claude\claude_desktop_config.json

3. 添加（使用双反斜杠）：

{
  "mcpServers": {
    "jymp": {
      "command": "C:\\Users\\yourusername\\AppData\\Roaming\\npm\\jymp-mcp-server.cmd"
    }
  }
}

4. 重启 Claude Desktop

---

📚 可用工具

1. get_codebase_files

列出目录中的所有文件（尊重 .jympignore）

示例：

"列出 /Users/me/my-app 中的所有文件"

2. create_codebase_prompt

将所有文件合并成一个LLM提示

示例：

"为 /Users/me/my-app 创建一个代码库提示，并进行基本压缩"

参数：

• directory: 项目路径
• compression: none 或 basic（可选）

3. create_prompt_from_files

将特定文件合并成一个提示

示例：

"合并 /Users/me/my-app 中的 src/index.ts 和 src/utils.ts"

参数：

• directory: 基础目录路径
• files: 文件路径数组
• compression: none 或 basic（可选）

---

⚙️ 配置

使用 .jympignore 排除文件

在项目根目录创建一个 .jympignore 文件：

node_modules
.git
dist
build
.env
*.log
.DS_Store
coverage/

服务器会自动尊重这些排除项。

压缩模式

• none（默认）：完整文件内容
• basic：移除注释、空行并压缩空白

---

🔧 故障排除

安装后出现 "command not found: jymp-mcp-server"

问题： npm 全局 bin 目录不在 PATH 中

解决方案：

# 将 npm 全局 bin 添加到您的 PATH
echo 'export PATH="$(npm bin -g):$PATH"' >> ~/.zshrc
source ~/.zshrc

# 然后重新安装
npm install -g @mahendra189/jymp-mcp-server

# 查找路径
which jymp-mcp-server

---

Perplexity 中出现 "服务器未运行"

解决方案：

1. 确保您使用了来自 which jymp-mcp-server 的完整路径
2. 先在终端测试命令：

/your/full/path/to/jymp-mcp-server

3. 尝试删除并重新添加连接器
4. 再次检查您是否正确复制了路径（无拼写错误）

---

Claude Desktop 中出现 "无法连接"

解决方案：

1. 完全退出 Claude Desktop（Cmd+Q，不仅仅是关闭窗口）
2. 确认您使用了来自 which jymp-mcp-server 的正确完整路径
3. 先在终端测试以确保其正常工作
4. 检查配置文件中的拼写错误
5. 确保 JSON 语法正确（逗号、引号等）

---

macOS 上的权限错误

Claude 可能需要磁盘访问权限：

1. 转到 系统设置 → 隐私与安全 → 文件和文件夹
2. 授予 Claude 访问您想要扫描的目录的权限

---

仍然存在问题？

运行这些诊断命令：

# 检查 Node.js 是否已安装
node --version

# 检查 npm 是否正常工作
npm --version

# 列出全局包
npm list -g --depth=0

# 查找 jymp-mcp-server 路径
which jymp-mcp-server

# 直接测试它
$(which jymp-mcp-server)

如果最后一个命令可以工作，则在 Perplexity/Claude 配置中使用确切的路径。

---

📖 示例用例

代码审查

"为 /Users/me/pull-request-branch 创建一个代码库提示"

获取所有更改的文件，以便与AI一起审查

文档

"列出 /Users/me/project/docs 中的所有文件"

查看您的文档结构

调试

"合并 /Users/me/project 中的 src/bug.ts 和 tests/bug.test.ts"

获取与AI一起调试的相关代码

新手引导

"为 /Users/me/new-project 创建一个代码库提示，并进行基本压缩"

获取新代码库的压缩概述

---

🗑️ 卸载

npm uninstall -g @mahendra189/jymp-mcp-server

---

🐛 报告问题

发现错误？有功能请求？

GitHub: https://github.com/mahendra189/jymp-mcp-server/issues

---

📄 许可证

MIT © Mahendra Kumar

---

🔗 相关项目

• JYMP CLI - 带有交互式UI的原始JYMP工具
• MCP 文档 - 更多关于模型上下文协议的信息

---

由 Mahendrakumar 制作 ❤️