STARWARCLOUD STARWAR.AI
返回市场
跳跃-MCP服务器

跳跃-MCP服务器

作者：mahendra1892 星标更新：2025-10-29
安装使用来源：spider==github.com

项目介绍

【技术文档摘要】

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 版本] [许可证：MIT]

📦 安装

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
  1. 点击 保存
  2. 等待状态显示 “运行中”（绿色）

使用方法

  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
  1. 打开配置文件：
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
  1. 添加（替换为步骤1中的您的路径）：
{
  "mcpServers": {
    "jymp": {
      "command": "/Users/yourusername/.nvm/versions/node/v22.10.0/bin/jymp-mcp-server"
    }
  }
}

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

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

Windows

  1. 查找您的安装路径：
where jymp-mcp-server
  1. 打开配置文件：
notepad %APPDATA%\Claude\claude_desktop_config.json
  1. 添加（使用双反斜杠）：
{
  "mcpServers": {
    "jymp": {
      "command": "C:\\Users\\yourusername\\AppData\\Roaming\\npm\\jymp-mcp-server.cmd"
    }
  }
}
  1. 重启 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
  1. 尝试删除并重新添加连接器
  2. 再次检查您是否正确复制了路径（无拼写错误）

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 制作 ❤️