eight-mcp-community

# eight-mcp-community [](https://app.codacy.com/gh/new-village/eight-mcp-community/dashboard) Unofficial Python client and stdio MCP server for Eight person-search workflows. > [!WARNING] > This project is unofficial and not affiliated with Eight or Sansan. It uses private/internal web endpoints that can change without notice. Keep cookies, credentials, and raw contact data out of GitHub, logs, issues, prompts, and public reports. ## Design This package follows the same idea as `note-mcp-community`, but the core is Python: - PyPI/project name: `eight-mcp-community` - Python import package: `eight` - CLI commands: `eight-mcp-community` and `eight-mcp` - MCP server: stdio, suitable for local/private agent use The core client is reusable without an LLM: ```python from eight import EightClient client = EightClient.from_default_config() result = client.search_person("鈴木太郎 東京商事") print(result.to_safe_dict()) ``` The MCP server is a thin wrapper over the same `EightClient`. ## Install / run Local development: ```bash uv sync --dev uv run eight-mcp-community --help uv run eight-mcp-community serve ``` Run directly without installing permanently: ```bash uvx eight-mcp-community serve ``` If Eight returns Cloudflare-style `403` responses with valid cookies, use the optional `curl_cffi` transport. It impersonates Chrome for the normal CLI/MCP path and does not require Playwright: ```bash uvx --from 'eight-mcp-community[cloudflare]' eight-mcp-community serve ``` If you install with `python -m pip install --user eight-mcp-community`, the command may be placed under `~/.local/bin`, which is not always on `PATH`. Either add that directory to `PATH`, use the absolute path, or run the module form: ```bash python -m eight serve ~/.local/bin/eight-mcp-community serve ``` MCP client configuration: ```json { "mcpServers": { "eight": { "command": "uvx", "arg…