使用说明

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已安装

安装，安装

克隆存储库：

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

.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を無視するかどうか

安装并配置依赖关系：

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 从文件生成配置文件
将生成的配置文件复制到相应的配置目录

重新启动应用程序：

单击功能区上的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中所述修改相应参数的值。此功能提供以下工具：

write_note: Obsidian 创建或更新注释
- path：注释路径（可选的.md扩展名）
- content：注释内容
- append: true 类型的多个类型参数的着色器的编译器中可能发生的故障
delete_note: Obsidian 删除注释
- path：要删除的注释路径
read_notes：一次读取多个注释
- paths：排列要读取的注释路径
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 那么有三个作用域：

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

基本使用流程

# 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使用作用域：

MCP设置时选择“项目”作用域
已生成.mcp.json打开文件Git承诺
在团队成员克隆项目之后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 を使用して入力パラメータのスキーマを定義します。

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

添加工具实现: server.setRequestHandler() 中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。
添加到配置文件: 模板文件（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}}"]
}
```
添加环境变量: 根据需要 .env 将新环境变量添加到文件中，然后单击README 中所述修改相应参数的值。

故障排除

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

开発方针

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

使用说明

Claude 扩展配置工具

概要

支持的功能

前提条件

安装，安装

Makefile 命令

Claude Desktop / Cursor IDE 用

Claude Code 用

共通

配置文件

自定义

Obsidian 使用功能

Claude Code 使用方法

MCP 关于作用域

基本使用流程

Claude Code内部确认

用于项目共享

故障排除

故障排除

开発方针

相关 MCP

Figma MCP服务器

Markdown转换服务

MCP 协议测试服务器

图像生成服务

代码安全扫描工具

网页内容抓取服务器