AI导哈

统一MCP服务器

Plurity的统一MCP服务器，通过单一API密钥提供审计、收费和智能服务。

  • by plurity-ai
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 plurity-ai/plurity-mcp

使用说明

plurity-mcp

Unified MCP server for all Plurity services — Audit, Toll, and Intelligence — using a single API key.

Installation

uvx plurity-mcp

Or install permanently:

uv tool install plurity-mcp

Quick start

1. Get an API key

Log in to account.plurity.ai → Settings → API Keys → Create key. Grant the scopes for each service you want to use (audit, toll, intelligence).

2. Run the setup wizard

plurity-mcp-setup

The wizard validates your key and saves it to ~/.config/plurity/config.toml.

3. Add to your MCP client

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "plurity": {
      "command": "uvx",
      "args": ["plurity-mcp"],
      "env": {
        "PLURITY_API_KEY": "plt_your_key_here"
      }
    }
  }
}

Configuration

Environment variables

Variable Default Description
PLURITY_API_KEY — Your plt_* API key (required)
PLURITY_ACCOUNTS_URL https://account.plurity.ai Override accounts API URL
PLURITY_AUDIT_URL https://audit.plurity.ai Override Audit API URL
PLURITY_TOLL_URL https://toll.plurity.ai Override Toll API URL
PLURITY_INTELLIGENCE_URL https://intelligence.plurity.ai Override Intelligence API URL
PLURITY_AUDIT_ENABLED true Set to false to disable Audit tools
PLURITY_TOLL_ENABLED true Set to false to disable Toll tools
PLURITY_INTELLIGENCE_ENABLED true Set to false to disable Intelligence tools

Config file (~/.config/plurity/config.toml)

[mcp]
api_key = "plt_..."
accounts_url = "https://account.plurity.ai"
audit_base_url = "https://audit.plurity.ai"
toll_base_url = "https://toll.plurity.ai"
intelligence_base_url = "https://intelligence.plurity.ai"
audit_enabled = true
toll_enabled = true
intelligence_enabled = true

Environment variables take precedence over the config file.

Service activation

On startup the server:

  1. Validates your API key against plurity-accounts
  2. Reads the key's scopes (e.g. ["audit", "toll"])
  3. Registers only the tools for services the key is scoped for
  4. Applies your *_ENABLED overrides — you can disable services the key has access to, but you cannot enable services the key lacks a scope for

If the key is invalid the server exits immediately with a clear error message visible in your MCP client.

Tools

Audit (GEO readiness)

Tool Description
submit_audit_scan Queue a URL for AI-readiness analysis
get_audit_scan Get scan status and results by ID
get_audit_scan_by_url Look up the latest scan for a URL
run_audit Submit and wait until complete (blocking)

Toll (agent traffic + llms.txt)

Tool Description
list_toll_sites List your sites/pages
create_toll_site Create a new site
get_toll_site Get site details (the site key is only ever returned by get_toll_installation_instructions)
update_toll_site Update name, domain, cache TTL, llms.txt mode
get_toll_installation_instructions Get integration code snippets for HTML/Next.js/React/GTM
list_toll_qa_pairs List Q&A pairs in a site's llms.txt
create_toll_qa_pair Add a Q&A entry to llms.txt
update_toll_qa_pair Edit a Q&A entry (or publish/unpublish it)
delete_toll_qa_pair Remove a Q&A entry
get_toll_traffic Agent traffic chart data (today/week/month/year)
list_toll_events Row-level events with UTM/host filters (visitor-identifying fields are redacted)
get_toll_llms_txt Fetch the currently served llms.txt body

Intelligence (question & topic monitoring)

Tool Description
list_intelligence_sources Browse the global source catalogue
list_subscribed_intelligence_sources List sources your org follows
subscribe_intelligence_source Subscribe to a source
unsubscribe_intelligence_source Unsubscribe from a source
request_intelligence_source Add a new source by URL (auto-subscribes)
list_intelligence_source_content List raw scraped documents
list_intelligence_qa_pairs Browse the Q&A feed with filters
approve_intelligence_qa_pair Move a Q&A pair into your knowledge base
skip_intelligence_qa_pair Dismiss a Q&A pair from the feed

Development

git clone https://github.com/plurity-oss/plurity-mcp
cd plurity-mcp
uv sync
uv run plurity-mcp-setup    # set up key
uv run plurity-mcp          # run locally

License

MIT

相关 MCP