pearl_mcp_server
The Pearl MCP Server is an implementation of a Model Context Protocol (MCP) server that exposes Pearl's AI and expert services through a standardized interface. This server allows MCP clients to interact with Pearl's advanced AI assistants and human experts. It features multiple interaction modes, session management, and conversation history tracking, enabling users to leverage quick automated responses or AI-assisted human expert support.
GitHub Stars
5
User Rating
Not Rated
Favorites
0
Views
35
Forks
1
Issues
1
Python 3.12 or higherPearl API KeyInstallation
Installation
Prerequisites
Installation Steps
1. Clone Repository
bash
git clone https://github.com/Pearl-com/pearl_mcp_server.git
cd pearl_mcp_server
2. Create and Activate Virtual Environment
bash
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
3. Install Dependencies
bash
pip install -e .
Troubleshooting
Common Issues
Issue: Server won't start Solution: Check Python version and reinstall dependencies.Configuration
Configuration
Basic Configuration
Setting Environment Variables
Create a.env file in the src directory and add the following:
env
PEARL_API_KEY=your-api-key-here
Advanced Configuration
Security Settings
Configuration Example
env
PEARL_API_KEY=your-api-key-here
Examples
Examples
Basic Usage
Starting the Server
bash
Start the server using stdio transport
pearl-mcp-server --api-key your-api-key
Start using SSE transport on a custom port
pearl-mcp-server --api-key your-api-key --transport sse --port 8000
Example API Call
python
import requests
def call_mcp_tool(tool_name, params):
response = requests.post(
'http://localhost:8000/mcp/call',
json={
'tool': tool_name,
'parameters': params
}
)
return response.json()
Usage example
result = call_mcp_tool('ask_pearl_ai', {'question': 'What is MCP?'})
Use Cases
Additional Resources
The Prospectio MCP API is a FastAPI-based application designed for lead prospecting, implementing the Model Context Protocol (MCP). It adheres to Clean Architecture principles, ensuring a clear separation of concerns across domain, application, and infrastructure layers. The project focuses on core business entities and logic, along with use cases and API routes, facilitating integration with external services.
This MCP server is a tool for retrieving agricultural production data via the USDA NASS API. It allows users to obtain datasets based on specific commodities, locations, and times, as well as count the number of records. Access to the data can be obtained by requesting an API key.