feat: add easy multi-project setup and tool discovery

Makes it simple to use the Telegram bridge MCP server in multiple
Claude projects with minimal configuration.

New Features:
- Auto-generate MCP config: `pnpm config`
- List available tools: `pnpm tools`
- Multi-project setup guide (SETUP-FOR-OTHER-PROJECTS.md)
- MCP config template (.claude-mcp-template.json)
- Helper scripts for config generation

Changes:
- Added scripts/get-mcp-config.sh - Auto-generates MCP config with correct paths
- Added scripts/list-tools.js - Lists all 5 MCP tools with descriptions
- Added SETUP-FOR-OTHER-PROJECTS.md - Guide for using in multiple projects
- Updated README with easier setup options
- Added npm scripts: `tools` and `config`

Now you can:
1. Install bridge once
2. Run `pnpm config` to get MCP config
3. Copy to any project's .claude/mcp.json
4. Use Telegram tools in that project!

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
RichardDillman
2025-11-23 01:04:16 -05:00
parent 6c8c9350a1
commit fdb1fa74b4
6 changed files with 326 additions and 7 deletions

View File

@@ -26,6 +26,19 @@ After trying email, SMS, and Google Chat integrations, Telegram emerged as the b
- 🔔 **Priority Notifications** - Different icons for info, success, warning, error, question
- 🌐 **HTTP API** - Easy integration from any app/project
- 🚀 **Background Service** - Runs independently, always available
- 🔧 **MCP Protocol** - Works as a standard MCP server in any Claude project
## Using in Other Projects
**Already have the bridge installed?** Just add this to your project's `.claude/mcp.json`:
```bash
# Quick command to get your config
cd /path/to/claude-telegram-bridge
./scripts/get-mcp-config.sh > ../your-project/.claude/mcp.json
```
Or manually copy the MCP config - see [SETUP-FOR-OTHER-PROJECTS.md](SETUP-FOR-OTHER-PROJECTS.md)
## Quick Start
@@ -89,6 +102,17 @@ pnpm daemon
### 5. Add MCP Server to Claude
#### Option A: Auto-Generate Config (Easiest)
```bash
cd claude-telegram-bridge
./scripts/get-mcp-config.sh
```
Copy the output to your MCP config file.
#### Option B: Manual Setup
Add to your Claude Code MCP settings (`~/.config/claude-code/settings/mcp.json`):
```json
@@ -107,15 +131,18 @@ Add to your Claude Code MCP settings (`~/.config/claude-code/settings/mcp.json`)
}
```
**Replace `/ABSOLUTE/PATH/TO/` with your actual path!**
To find your absolute path:
**Find your path:**
```bash
cd claude-telegram-bridge
pwd
# Copy the output and use: <output>/dist/mcp-server.js
cd claude-telegram-bridge && pwd
# Use output: <result>/dist/mcp-server.js
```
#### MCP Config Locations
- **Global (all projects):** `~/.config/claude-code/settings/mcp.json`
- **Per-project:** `your-project/.claude/mcp.json`
- **VS Code:** `your-project/.vscode/mcp.json`
### 6. Available Tools
Once configured, Claude can automatically use:
@@ -125,6 +152,13 @@ Once configured, Claude can automatically use:
- `telegram_reply` - Reply to your messages
- `telegram_check_health` - Check bridge status
**View detailed tool info:**
```bash
pnpm tools
# or
node scripts/list-tools.js
```
### 7. Test It
Restart Claude Code, then tell Claude: