SignNow电子签名MCP服务

Prerequisites

• SignNow account. Create a free developer account.
• SignNow Credentials: You will need your account email, password, and the application Basic Authorization Token. Getting started.
• An active SignNow API application.
• Python 3.11+ installed on your system (check with python3 --version)
• UVX installed  (check with uvx --version). Recommended for the quickest setup.
• Environment variables configured
• If your client supports Streamable HTTP, you can use the pre-deployed server URL https://mcp-server.signnow.com/mcp instead of running it locally.

Or create .env file manually with required variables (see Environment Variables section below)

```

Optional direct API token (not required for normal use)

SIGNNOW_TOKEN=<access_token>

Make sure you have the required dependencies installed

pip install langchain-openai langchain-mcp-adapters # for LangChain example pip install llama-index-tools-mcp # for LlamaIndex example pip install smolagents # for SmolAgents example

1. Setup Environment Variables

```bash

2. Install and Run

Option A: Install from PyPI (Recommended)

```bash

Install the package from PyPI

pip install signnow-mcp-server

2) Install (editable for dev)

pip install -e .

Docker

```bash

Build

docker build -t sn-mcp-server .

Docker Compose

```bash

Client setup

Quick start

You can copy from env.example if you have the source code

Examples

The examples/ directory contains working examples of how to integrate the SignNow MCP Server with popular AI agent frameworks:

• LangChain - Integration with LangChain agents using langchain-mcp-adapters
• LlamaIndex - Integration with LlamaIndex agents using llama-index-tools-mcp
• SmolAgents - Integration with SmolAgents framework using native MCP support

Each example demonstrates how to: - Start the MCP server as a subprocess - Convert MCP tools to framework-specific tool formats - Create agents that can use SignNow functionality - Handle environment variable configuration

To run an example: ```bash

Then run the example

python examples/langchain/langchain_example.py python examples/llamaindex/llamaindex_example.py python examples/smolagents/stdio_demo.py ```

---

Sample apps

Explore ready-to-use sample apps to quickly test preparing, signing, and sending documents from your software using the SignNow API.

Try the sample apps.

Create .env file with your SignNow credentials

1) Clone & configure

git clone https://github.com/signnow/sn-mcp-server.git cd sn-mcp-server cp .env.example .env

fill in your values in .env

Configuration

Copy .env.example → .env and fill in values. All settings are validated via pydantic-settings at startup.

Authentication options

1) Username / Password (recommended for desktop dev flows)

SIGNNOW_USER_EMAIL=<email>
SIGNNOW_PASSWORD=<password>
SIGNNOW_API_BASIC_TOKEN=<base64 basic token>

2) OAuth 2.0 (for hosted/advanced scenarios)

``` SIGNNOW_CLIENT_ID=<client_id> SIGNNOW_CLIENT_SECRET=<client_secret>

+ OAuth server & RSA settings below

```

When running via some desktop clients, only user/password may be supported.

SignNow & OAuth settings

```

Set up your .env file with SignNow credentials and LLM configuration

SignNow endpoints (defaults shown)

SIGNNOW_APP_BASE=https://app.signnow.com SIGNNOW_API_BASE=https://api.signnow.com

API documentation

Find technical details on SignNow API requests, parameters, code examples, and possible errors. Learn more about the API functionality in detailed guides and use cases.

Read the API documentation.

SignNow API Helper MCP

Connect your AI to access API docs, generate code for complex signing workflows, and troubleshoot integration errors automatically. Access the API Helper MCP

---

VS Code — GitHub Copilot (Agent Mode) / Cursor

Create .vscode/mcp.json / .cursor/mcp.json in your workspace:

STDIO (local):

{
  "servers": {
    "signnow": {
      "command": "sn-mcp",
      "args": ["serve"],
      "env": {
        "SIGNNOW_USER_EMAIL": "${env:SIGNNOW_USER_EMAIL}",
        "SIGNNOW_PASSWORD": "${env:SIGNNOW_PASSWORD}",
        "SIGNNOW_API_BASIC_TOKEN": "${env:SIGNNOW_API_BASIC_TOKEN}"
      }
    }
  }
}

STDIO (uvx — no local install):

{
  "servers": {
    "signnow": {
      "command": "uvx",
      "args": ["--from", "signnow-mcp-server", "sn-mcp", "serve"],
      "env": {
        "SIGNNOW_USER_EMAIL": "${env:SIGNNOW_USER_EMAIL}",
        "SIGNNOW_PASSWORD": "${env:SIGNNOW_PASSWORD}",
        "SIGNNOW_API_BASIC_TOKEN": "${env:SIGNNOW_API_BASIC_TOKEN}"
      }
    }
  }
}

HTTP (remote or Docker):

{
  "servers": {
    "signnow": {
      "type": "http",
      "url": "http://localhost:8000/mcp"
    }
  }
}

Then open Chat → Agent mode, enable the signnow tools, and use them in prompts.

Note: The same configuration applies in Cursor — add it under MCP settings (STDIO or HTTP). For STDIO, you can also use uvx as shown above.

FAQ / tips

• STDIO vs Docker? Prefer STDIO for local dev; inside Docker, use HTTP.
• Sandbox vs production? Start with SignNow’s sandbox/dev credentials; production requires proper OAuth and persistent RSA private key.
• Where do I see exact tool schemas? Use MCP Inspector or your client’s “tool details” view.
• Where are examples? See examples/ in this repo for starter integrations.

---