https://github.com/Pearch-ai/mcp_pearch
https://github.com/Pearch-ai/mcp_pearch
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/Pearch-ai/mcp_pearch
- Owner: Pearch-ai
- License: mit
- Created: 2025-06-17T08:16:19.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-06-17T08:22:09.000Z (5 months ago)
- Last Synced: 2025-06-17T09:36:19.695Z (5 months ago)
- Language: Python
- Size: 4.88 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - Pearch-ai/mcp_pearch - 人材発掘にかかる時間を短縮する、最高の人物検索エンジン (サーバー実装 / 🔎 <a name="search"></a>検索・データ抽出)
- awesome-mcp-servers - Pearch - Best people search engine that reduces the time spent on talent discovery. (Official Servers)
- awesome-mcp-servers - **Pearch-ai/mcppearch 🎖️ 🐍 ☁️** - Best people search engine that reduces the time spent on talent discovery `http` `ai` `git` `github` (📦 Other)
README
# Pearch.ai MCP
[](https://smithery.ai/server/@Pearch-ai/mcp_pearch)
Pearch.ai MCP is a FastMCP service that enables powerful people search capabilities through the Pearch.ai. This service allows you to integrate advanced people search functionality into your applications.
## Prerequisites
- Python 3.7 or newer
- Pearch.ai API key
- FastMCP package
## API Key Setup
1. Visit [Pearch.ai Dashboard](https://s.pearch.ai/) to obtain your API key
2. For testing purposes, you can use the test key: `pearch_mcp_key`
3. Set your API key as an environment variable:
```bash
export PEARCH_API_KEY='your-api-key-here'
```
## Installation
### Installing via Smithery
To install mcp_pearch for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@Pearch-ai/mcp_pearch):
```bash
npx -y @smithery/cli install @Pearch-ai/mcp_pearch --client claude
```
### Option 1: macOS[uv]
```bash
# Install Python and uv
brew install python
brew install uv
# Create and activate virtual environment
uv venv
source .venv/bin/activate
# Install FastMCP
uv pip install fastmcp
```
### Option 2: Linux[pip]
```bash
# Install system dependencies
sudo apt update
sudo apt install python3 python3-venv python3-pip
# Create and activate virtual environment
python3 -m venv .venv
source .venv/bin/activate
# Install FastMCP
pip install fastmcp
```
## Usage
### Standard Installation
```bash
fastmcp install pearch_mcp.py --name "Pearch.ai" --env-var PEARCH_API_KEY=pearch_mcp_key
```
### Development Mode
For local development and testing:
```bash
# Set your API key
export PEARCH_API_KEY='your-api-key-here'
# Start development server
fastmcp dev pearch_mcp.py
```
## Contributing
We welcome contributions! Here's how you can help:
1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
Please ensure your code follows our coding standards and includes appropriate tests.
## Support
If you encounter any issues or have questions:
- Open an issue in the repository
- Contact support at [support@pearch.ai](mailto:support@pearch.ai)
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.