stefanstranger/signal-mcp-server

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

8 stars 6 forks 质量 52 趋势 16

Repository Install

Sigal MCP Server

概览

MCP Server for retrieving Signal messages using signal-export logic. This MCP server enables AI agents and tools to access Signal Desktop chat messages and attachments via the Model Context Protocol (MCP). - Retrieve Signal messages from your local Signal Desktop database - List all Signal chats with contact details and message counts - Filter messages by chat/contact name - Paginate through message history with offset and limit - Support for multiple operating systems (Windows, macOS, Linux) - Handle encrypted Signal databases - Python 3.13 or higher - UV package manager - Signal Desktop installed with existing message database - Node.js and npm (for MCP inspector tools) - Windows, macOS, or Linux operating system Signal Desktop requires Signal to be installed on your phone for initial setup. - Download the installer for your OS (Windows, macOS, Linux) and follow the setup instructions. - https://github.

README

以下为原文 README 节选，完整内容请查看原文。

📱 signal-mcp-server

MCP Server for retrieving Signal messages using signal-export logic.

🎯 Overview

This MCP server enables AI agents and tools to access Signal Desktop chat messages and attachments via the Model Context Protocol (MCP).

🛠️ Features

Retrieve Signal messages from your local Signal Desktop database
List all Signal chats with contact details and message counts
Filter messages by chat/contact name
Paginate through message history with offset and limit
Support for multiple operating systems (Windows, macOS, Linux)
Handle encrypted Signal databases

📋 Prerequisites

Python 3.13 or higher
UV package manager
Signal Desktop installed with existing message database
Node.js and npm (for MCP inspector tools)
Windows, macOS, or Linux operating system

1. Signal Desktop

Official Download Page:
https://signal.org/download/
Direct Download Links:

Note: Signal Desktop requires Signal to be installed on your phone for initial setup.

2. Python

Official Download Page:
https://www.python.org/downloads/
Direct Download for Python 3.13.5:
Python 3.13.5 Release Page
Download the installer for your OS (Windows, macOS, Linux) and follow the setup instructions.

3. UV (Python Package Manager)

Official Documentation & Source:
https://github.com/astral-sh/uv
UV Documentation
Installation (Windows):
```
irm https://astral.sh/uv/install.ps1 | iex
```
Or, using pip (if you already have Python and pip installed):
```
pip install uv
```

Installation (macOS/Linux):

curl -LsSf https://astral.sh/uv/install.sh | sh

More Info:
UV Installation Guide

4. Claude Desktop

Official Download Page:
https://claude.ai/download
Download the installer for your OS (Windows, macOS) and follow the setup instructions.

🚀 Installation Signal MCP Server

Clone the repository:

git clone https://github.com/stefanstranger/signal-mcp-server.git
cd signal-mcp-server

Create a virtual environment:
```
uv venv .venv --python 3.13
```
Activate the virtual environment:
- Windows PowerShell:
```
.\.venv\Scripts\Activate.ps1
```
- macOS/Linux:
```
source .venv/bin/activate
```
Install dependencies:
```
uv pip install fastmcp signal-export
```

⚙️ Configuration

🔧 Claude Desktop Setup

在 GitHub 查看完整 README

安装

npx @modelcontextprotocol/inspector uv run --with mcp[cli] mcp run c://github//signal-mcp-server//server.py

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "signal-mcp-server": {
         "type": "stdio",
         "command": "uv",
         "args": [
            "run",
            "--with",
            "mcp[cli]",
            "--with",
            "signal-export",
            "mcp",
            "run",
            "C:\\Github\\signal-mcp-server\\server.py"
         ]
    }
  }
}