Claude MCP Servers

Claude 扩展配置工具

此存储库包含：Claude 桌面应用程序Cursor IDE、克劳德代码中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。

概要

Makefile 中描述的场景，使用下列步骤创建明细表，以便在概念设计中分析体量的周长claude_desktop_config.template.json在工作空间的边缘cursor_config.template.json）和 .env 从文件到配置文件（claude_desktop_config.json在工作空间的边缘config.json），模板名称将采用不同的格式Claude 桌面应用程序或Cursor IDE的明细栏样式中定义的设置。

Claude Code面向个别MCP还提供服务器管理功能。

支持的功能

此存储库提供Claude 桌面应用程序和Cursor IDE将条目添加到文档注册表

• Brave 検索: Web 搜索和区域搜索
• 文件系统：使用本地文件
• Git：存储库操作
• GitHub：存储库管理
• 外壳：执行命令
• 操纵者: Web 刻划
• 获取: HTTP 请求
• Claude CLI：命令行协作
• AWS文档: AWS 查找相关信息
• Supabase：数据库协作
• 黑曜石: Obsidian 使用注释

前提条件

• 包子已安装
• 在系统中 make 已安装
• Claude 桌面应用程序Cursor IDE、在工作空间的边缘克劳德代码已安装
• uvx已安装（如果使用AWS Documentation功能）
• Claude Code用: Claude CLI已安装

安装，安装

1. 克隆存储库：

   git clone git@github.com:drapon/claude-mcp-servers.git
   cd claude-ts-mcps

1. .env 创建文件：

以下内容的 .env 创建文件并设置所需的值。

   # API Keys and Tokens
   BRAVE_API_KEY=your_brave_api_key         # Brave検索のAPI Key
   GITHUB_TOKEN=your_github_personal_access_token  # GitHub個人アクセストークン
   SUPABASE_API_KEY=your_supabase_api_key   # SupabaseのAPI Key
   FIGMA_API_KEY=your_figma_api_key         # FigmaのAPI Key

   # Executables Paths
   BUN_PATH=/path/to/bun                    # bunコマンドのフルパス（通常は /opt/homebrew/bin/bun）
   UVX_PATH=/path/to/uvx                    # uvxコマンドのフルパス（通常は /usr/local/bin/uvx）
   NPX_PATH=/path/to/npx                    # npxコマンドのフルパス
   CLAUDE_CLI_PATH=/path/to/claude/cli      # Claude CLIのフルパス

   # Directories
   HOME_DIR=/your/home/directory            # ホームディレクトリのパス
   OBSIDIAN_VAULT_DIR=/path/to/obsidian/vault  # Obsidianのvaultディレクトリ
   CURSOR_WORKSPACE_PATH=/path/to/workspace    # Cursorのワークスペースパス (Cursor用)

   # Fetch Tool Configuration
   CUSTOM_USER_AGENT=Mozilla/5.0 (...)      # カスタムユーザーエージェント設定
   IGNORE_ROBOTS_TXT=false                  # robots.txtを無視するかどうか

1. 安装并配置依赖关系：

Claude Desktop用于：

   # MCPサーバーを選択的に有効化する（推奨）
   make select-mcps

   # または、従来の自動セットアップ
   make setup

Cursor IDE用于：

   # Cursor用のMCPサーバーを設定
   ./scripts/setup_cursor_mcp.sh

Claude Code用于：

   # 個別MCPサーバーをビルドして対話的に設定（推奨）
   make reset-and-setup-claude-code

   # または、リセットせずに追加設定
   make setup-claude-code

   # 既存の設定をリセットのみ
   make reset-claude-code

   # 設定済みMCPサーバーの確認
   make list-claude-code-mcps

这将执行以下操作：

- 根目录和ts安装目录相关性 - select-mcps如果使用： - 启用MCP可以选择服务器 - 您可以交互式输入所需的环境变量 - 模板文件（claude_desktop_config.template.json在工作空间的边缘cursor_config.template.json）和 .env 从文件生成配置文件 - 将生成的配置文件复制到相应的配置目录

1. 重新启动应用程序：

单击功能区上的Claude 桌面应用程序Cursor IDE中所述修改相应参数的值。

Makefile 命令

Claude Desktop / Cursor IDE 用

• make all 在工作空间的边缘 make：默认目标。setup 运行目标
• make setup：安装依赖关系并生成配置文件Claude 复制到桌面应用程序的设置目录
• make select-mcps：交互式MCP选择并设置服务器。还可以设置所需的环境变量
• make cursor-setup: Cursor IDE的规格化距离的幂函数
• make cursor-interactive: Cursor IDE进行动态观察时的轴心点

Claude Code 用

• make build-individual-mcps：单个MCP打开服务器dist/在目录中构建
• make setup-claude-code: Claude Code用于MCP交互式配置服务器
• make reset-and-setup-claude-code：重置现有设置，然后重新设置新设置（建议）
• make reset-claude-code：现有Claude Code MCP重置设置
• make list-claude-code-mcps：当前设置MCP列出服务器

共通

• make install：仅安装相关性
• make clean：删除生成的配置文件和构建文件

配置文件

• claude_desktop_config.template.json: Claude Desktop功能设置模板文件
• cursor_config.template.json: Cursor IDE功能设置模板文件
• .env：定义环境变量的文件（存储库中不包含）
• claude_desktop_config.json: Claude Desktop而需要与环境混合的每条反射光线，进行环境采样
• config.json: Cursor IDE而需要与环境混合的每条反射光线，进行环境采样

自定义

.env 可以通过修改文件和模板文件来自定义设置：

• .env：在此定义特定于环境的值和密码
• 模板文件：根据需要更改功能设置模板
• 交互式选择: make select-mcps 想要使用MCP只能启用服务器

Obsidian 使用功能

Obsidian 单击功能区上的.env在文件中OBSIDIAN_VAULT_DIR中所述修改相应参数的值。此功能提供以下工具：

1. write_note: Obsidian 创建或更新注释

- path：注释路径（可选的.md扩展名） - content：注释内容 - append: true 类型的多个类型参数的着色器的编译器中可能发生的故障

1. delete_note: Obsidian 删除注释

- path：要删除的注释路径

1. read_notes：一次读取多个注释

- paths：排列要读取的注释路径

1. search_notes：按注释名搜索

- query：搜索查询（不区分大小写）

例：

// ノートを作成する
write_note({"path": "Projects/新しいプロジェクト", "content": "# 新しいプロジェクト\n\nここにプロジェクトの詳細を記述します。"})

// ノートに追記する
write_note({"path": "Projects/新しいプロジェクト", "content": "## 追加情報\n\nここに追加情報を記述します。", "append": true})

// ノートを検索する
search_notes({"query": "プロジェクト"})

// ノートを読み取る
read_notes({"paths": ["Projects/新しいプロジェクト", "Daily/2025-04-12"]})

// ノートを削除する
delete_note({"path": "Projects/古いプロジェクト"})

Claude Code 使用方法

Claude Code 表示个别MCP管理采用了，每个项目都需要MCP只能选择服务器来使用。

MCP 关于作用域

Claude Code 那么有三个作用域：

1. 本地（默认）：仅在当前项目中可用
2. 项目: .mcp.json可在文件中共享团队
3. 用户：可用于所有项目

基本使用流程

# 1. 個別MCPサーバーをビルド
make build-individual-mcps

# 2. 既存設定をリセットして新規設定（推奨）
make reset-and-setup-claude-code

# 3. Claude Code内で動作確認
claude code
# Claude Code内で: /mcp

Claude Code内部确认

Claude Code中的命令：MCP查看服务器状态：

/mcp

由此，被连接MCP显示服务器的列表和状态。

用于项目共享

单击功能区上的project使用作用域：

1. MCP设置时选择“项目”作用域
2. 已生成.mcp.json打开文件Git承诺
3. 在团队成员克隆项目之后Claude Code自动MCP识别服务器

故障排除

• Claude CLI缺少: Claude CLI确认是否正确安装
• MCP服务器未连接: make list-claude-code-mcps确认设置
• 权限错误: Claude Code执行时MCP批准
• 重置设置: make reset-claude-code清除所有设置

## MCP の開発と拡張

このリポジトリに新しい MCP を追加する方法：

1. **新しいサーバーファイルの作成**:
   `/ts/src/` ディレクトリに新しい `.ts` ファイルを作成します。既存のファイル（例：`obsidian.ts`）を参考にできます。

2. **必要なスキーマの定義**:
   Zod を使用して入力パラメータのスキーマを定義します。

const MyToolArgsSchema = z.object({ param1: z.string().describe("パラメータ1の説明"), param2: z.number().optional().describe("オプションのパラメータ2"), });

3. **添加工具实现**:
   `server.setRequestHandler()` 中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。

1. **添加到配置文件**:
   模板文件（`claude_desktop_config.template.json`打开`cursor_config.template.json`）新的MCP 中所述修改相应参数的值。

"my-new-tool": { "command": "{{BUN_PATH}}", "args": ["run", "{{PROJECT_ROOT}}/ts/src/my-new-tool.ts", "{{SOME_PARAMETER}}"] }

1. **添加环境变量**:
   根据需要 `.env` 将新环境变量添加到文件中，然后单击README 中所述修改相应参数的值。

## 故障排除

- 如果出现问题，请检查控制台输出并确认是否有错误消息
- `.env` 确保文件路径正确
- `bun` 请确认命令是否起作用
- Obsidian 在功能的情况下`OBSIDIAN_VAULT_DIR`请确保已正确设置
- 单击功能区上的`make setup`来定义自定义外观
- Cursor IDE的规格化距离的幂函数Cursor的设定画面中MCP确认的设置路径是否正确指定

## 开発方针

此项目作为包管理器[包子](https://bun.sh/)中所述修改相应参数的值。npm 屋脊yarn 等其他软件包管理器不受支持，因此所有安装和运行`bun`来修改标记元素的显示属性。