Claude Extension Configuration Tool

This repository is a tool for managing the feature extension settings of the Claude desktop application and Cursor IDE.

Overview

Using a Makefile, this tool automatically generates configuration files (claude_desktop_config.json or config.json) from templates (claude_desktop_config.template.json or cursor_config.template.json) and a .env file, and installs them into the configuration directory of the Claude desktop application or Cursor IDE.

Supported Features

This repository enables the following features in the Claude desktop application and Cursor IDE:

• Brave Search: Web and local search
• Filesystem: Local file operations
• Git: Repository operations
• GitHub: Repository management
• Shell: Command execution
• Puppeteer: Web scraping
• Fetch: HTTP requests
• Claude CLI: Command line integration
• AWS Documentation: Searching AWS-related information
• Supabase: Database integration
• Obsidian: Obsidian note operations

Prerequisites

• Bun is installed
• make is installed on your system
• The Claude desktop application or Cursor IDE is installed
• uvx is installed (if using the AWS Documentation feature)

Setup

1. Clone the repository:

   bash
   git clone https://github.com/yourusername/claude-ts-mcps.git
   cd claude-ts-mcps

2. Create a .env file:

   Create a .env file with the following content and set the necessary values.

   API Keys and Tokens

   BRAVE_API_KEY=your_brave_api_key # Brave search API Key
   GITHUB_TOKEN=your_github_personal_access_token # GitHub personal access token
   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 # Full path to bun command (usually /opt/homebrew/bin/bun)
   UVX_PATH=/path/to/uvx # Full path to uvx command (usually /usr/local/bin/uvx)
   NPX_PATH=/path/to/npx # Full path to npx command
   CLAUDE_CLI_PATH=/path/to/claude/cli # Full path to Claude CLI

   Directories

   HOME_DIR=/your/home/directory # Path to home directory
   OBSIDIAN_VAULT_DIR=/path/to/obsidian/vault # Path to Obsidian vault directory
   CURSOR_WORKSPACE_PATH=/path/to/workspace # Path to Cursor workspace (for Cursor)

   Fetch Tool Configuration

   CUSTOM_USER_AGENT=Mozilla/5.0 (...) # Custom user agent setting
   IGNORE_ROBOTS_TXT=false # Whether to ignore robots.txt

3. Install and configure dependencies:

   For Claude Desktop:
   bash

   Selectively enable MCP servers (recommended)

   make select-mcps

   Or, use the traditional automatic setup

   make setup

   For Cursor IDE:
   bash

   Set up MCP servers for Cursor

   ./scripts/setup_cursor_mcp.sh

   This will perform the following actions:

   • Install dependencies in the root directory and ts directory
   • If using select-mcps:
     • You can select which MCP servers to enable
     • You can input the required environment variables interactively- The configuration file is generated from the template file (claude_desktop_config.template.json or cursor_config.template.json) and the .env file.

• The generated configuration file is copied to the appropriate configuration directory.

1. Restart the application:

   To apply the changes, please restart the Claude Desktop app or Cursor IDE.

Makefile Commands

• make all or make: The default target. Runs the setup target.
• make setup: Installs dependencies, generates the configuration file, and copies it to the Claude Desktop app's configuration directory.
• make select-mcps: Interactively selects MCP servers for configuration. Also allows setting necessary environment variables.
• make install: Installs only the dependencies.
• make clean: Removes the generated claude_desktop_config.json file.

Configuration Files

• claude_desktop_config.template.json: Template file for feature settings of Claude Desktop.
• cursor_config.template.json: Template file for feature settings of Cursor IDE.
• .env: File for defining environment variables (not included in the repository).
• claude_desktop_config.json: Generated configuration file for Claude Desktop (not included in the repository).
• config.json: Generated configuration file for Cursor IDE (not included in the repository).

Customization

You can customize the settings by modifying the .env file and the template files:

• .env: Define environment-specific values and secrets here.
• Template Files: Modify the feature settings templates as needed.
• Interactive Selection: Use make select-mcps to enable only the MCP servers you wish to use.

How to Use Obsidian Features

To use Obsidian features, you need to set OBSIDIAN_VAULT_DIR in the .env file. This feature provides the following tools:

1. write_note: Creates or updates an Obsidian note.

   • path: Path to the note (.md extension is optional).
   • content: Content of the note.
   • append: If true, appends to the existing note (optional).

2. delete_note: Deletes an Obsidian note.

   • path: Path to the note to be deleted.

3. read_notes: Reads multiple notes at once.

   • paths: Array of paths to the notes to be read.

4. search_notes: Searches for notes by name.

   • query: Search query (case-insensitive).

Example:

javascript
// Create a note
write_note({"path": "Projects/新しいプロジェクト", "content": "# 新しいプロジェクト\n\nここにプロジェクトの詳細を記述します。"})

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

// Search for notes
search_notes({"query": "プロジェクト"})

// Read notes
read_notes({"paths": ["Projects/新しいプロジェクト", "Daily/2025-04-12"]})

// Delete a note
delete_note({"path": "Projects/古いプロジェクト"})

Developing and Extending MCPs

How to add a new MCP to this repository:

1. Create a new server file:
   Create a new .ts file in the /ts/src/ directory. You can refer to existing files (e.g., obsidian.ts).

2. Define required schemas:Use Zod to define the schema for input parameters.

typescript
const MyToolArgsSchema = z.object({
param1: z.string().describe("Description for parameter 1"),
param2: z.number().optional().describe("Optional parameter 2"),
});

1. Add Tool Implementation:
   Implement the tool's behavior within server.setRequestHandler().

2. Add to Configuration Files:
   Add the new MCP settings to the template files (claude_desktop_config.template.json and cursor_config.template.json).

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

1. Add Environment Variables:
   Add any new environment variables to the .env file as needed, and update the README.

Troubleshooting

• If you encounter issues, check the console output for error messages.
• Ensure that the path in the .env file is correct.
• Verify that the bun command is working properly.
• For Obsidian features, make sure OBSIDIAN_VAULT_DIR is correctly set.
• If problems occur during interactive setup, try setting up using the traditional method with make setup.
• If there are issues with Cursor IDE settings, check that the MCP configuration path is correctly specified in the Cursor settings interface.

Development Guidelines

This project uses Bun exclusively as the package manager. Since other package managers like npm or yarn are not supported, please use the bun command for all installations and executions.