Individual Application Mesh, MCP Server
Project description
IAM MCP SERVER ... kind of ๐ค
Individual Applicant Mesh MCP Server, server for processing and managing applicant resumes, and search for jobs. This server provides tools and prompts for job search, resume aggregation, job-specific resume, and cover letter, generation.
Indeed, is not really solving any integration but providing specific functionaliy for a MCP host, therefore, the kinf of ๐ค.
๐ Requirements
-
๐๏ธ The MCP host must have read and write access to the local file system where it is running. For example, you can run the
IAM MCP ServerwithinClaude Desktop, alongside thefilesystemMCP Server, which provides this capability. This file access requirement applies to version1.0and is necessary for proper operation. -
๐ The
search jobMCP tool requires access to JSearch. You can create an account and get 200 requests per month for free.
โจ Features
Prompts
๐ Analyze Job Market
Directs the LLM step-by-step to perform tasks such as conducting a job search, then summarizes and analyzes the resulting job listings. Refer to the full prompt for detailed instructions and context.
๐ Resume Mesh
Easily combine multiple targeted resumes into a single, comprehensive Markdown document.
What is Resume Mesh?
If youโve applied to similar jobs, youโve likely created several versions of your resume to match different job descriptions. Resume Mesh brings all those versions together into one unified Markdown file. This gives the MCP host a complete view of your experience and makes it easy to generate new, tailored resumes for future applications.
๐ฏ Job-Specific Resume Generation
Generate customized resumes for individual job postings.
To use this feature, make sure the MCP host already has access to the resume mesh. Each tailored resume is generated using both the resume mesh and the specific job description. You need to attach the resume mesh to the MCP host conversation in advance, because the resume generation prompt does not instruct the LLM to load the resume mesh from the file system.
Cover-Letter Generation
Easily generate a customized cover letter tailored to a specific job description, using the corresponding generated resume.
How to use:
Before generating a cover letter, ensure the MCP host has access to the relevant generated resume for the target job. You must manually attach this resume to the MCP host conversation, as the cover letter prompt does not automatically retrieve it from the file system.
๐พ Save Job
Directs the LLM step-by-step to save jobs.
How to use:
Start by searching for jobs using the search jobs MCP tool. After obtaining the results, you can then instruct the LLM to save those job listings.
Tools
๐ Search Jobs
Performs a job search using the following parameters:
- role: The job title or position to search for
- city: (optional) Target city for the job search
- country: (optional) Target country for the job search
- platform: (optional) Specific job platform to use
- number of jobs: (default 5) Number of job listings to retrieve
- slice job description: (optional) Option to include only a portion of the job description
๐ ๏ธ Installation & Setup
You can easily install this project as a Python package from PyPI: iam-mcp-server.
๐ฅ๏ธ MCP host (Claude Desktop)
- Locate your
claude_desktop_config.jsonfile:- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
Option 1: Using uvx with PyPI package
{
"mcpServers": {
"iam": {
"command": "uvx",
"args": [
"--from",
"iam-mcp-server@latest",
"mcp-server-iam"
],
"env": {
"LOG_LEVEL": "INFO",
"RAPIDAPI_KEY": "<API KEY>",
"RAPIDAPI_HOST": "jsearch.p.rapidapi.com",
"MCP_TRANSPORT": "stdio"
}
}
}
Option 2: Using source code
{
"mcpServers": {
"iam": {
"command": "<path to>/uv",
"args": [
"--directory",
"<path to>/iam-mcp-server/src/mcp_server_iam",
"run",
"__main__.py"
],
"env": {
"LOG_LEVEL": "INFO",
"RAPIDAPI_KEY": "<API KEY>",
"RAPIDAPI_HOST": "jsearch.p.rapidapi.com",
"MCP_TRANSPORT": "stdio"
}
}
}
}
Restart your MCP host
- Completely quit and restart your MCP host
- The server will automatically initialize when the host starts
Verify the connection
In your MCP host, ask: "What MCP tools are available?" or "List the available MCP servers"
๐ MCP Inspector
In terminal, run mcp dev src/mcp_server_iam/__main__.py and accept installing the MCP Inspector.
In the web inspector UI, click connect and interact with the MCP server.
โ ๏ธ Important, this is for dev purposes only.
โ๏ธ Environment Variables
IAM supports configuration through environment variables. Create a .env file in the project root or set these variables in your system:
| Variable | Default | Description |
|---|---|---|
APP_NAME |
iam |
Application name for logging and identification |
LOG_LEVEL |
INFO |
Logging level: DEBUG, INFO, WARNING, ERROR, CRITICAL |
MCP_TRANSPORT |
stdio |
Application transport version |
RESUME_MESH_FILENAME |
resume_mesh |
Default filename for resume mesh |
RAPIDAPI_KEY |
"" |
RapidAPI key for external API access (optional) |
RAPIDAPI_HOST |
jsearch.p.rapidapi.com |
RapidAPI host endpoint |
๐ Repository Structure
iam-mcp-server/
โโโ src/ # Source code
โ โโโ mcp_server_iam/ # Main MCP server package
โ โโโ __init__.py # Package initialization
โ โโโ __main__.py # Entry point for running the server
โ โโโ config.py # Configuration management
โ โโโ prompt.py # LLM prompts and instructions
โ โโโ server.py # MCP server implementation
โ โโโ tool.py # MCP tools implementation
โ โโโ utils.py # Utility functions
โโโ tests/ # Test suite
โ โโโ __init__.py
โ โโโ test_mcp_tools.py # MCP tools tests
โโโ .env_example # Environment variables template
โโโ LICENSE # MIT License
โโโ makefile # Build and development tasks
โโโ pyproject.toml # Project configuration and dependencies
โโโ pytest.ini # Pytest configuration
โโโ README.md # This file
โโโ ruff.toml # Ruff linter configuration
โโโ uv.lock # UV dependency lock file
๐ Key Components
-
src/mcp_server_iam/: Core MCP server implementationserver.py: Main MCP server class and protocol handlingtool.py: Implementation of MCP tools (job search, etc.)prompt.py: LLM prompts for resume generation and job analysisconfig.py: Configuration management and environment variablesutils.py: Helper functions and utilities
-
tests/: Comprehensive test suite for MCP tools and functionality -
Configuration files: Project setup, linting, and dependency management
๐ License
MIT License - see LICENSE file for details
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file iam_mcp_server-1.1.4.tar.gz.
File metadata
- Download URL: iam_mcp_server-1.1.4.tar.gz
- Upload date:
- Size: 68.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
08fcb1660838bbbf29a645399faf8060f24e08a7ce58c271028343889ddc62c6
|
|
| MD5 |
0cfa22568180d7a091b43b2dd8b12675
|
|
| BLAKE2b-256 |
14147649dda1862e173dfbf25c151f226f2c7474095c39f80cd723881dae9526
|
File details
Details for the file iam_mcp_server-1.1.4-py3-none-any.whl.
File metadata
- Download URL: iam_mcp_server-1.1.4-py3-none-any.whl
- Upload date:
- Size: 21.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ba5f6f412bfc8c00215c417c40496824abeb1b3609d4f124c3eb236de56368c1
|
|
| MD5 |
ac4dc981001fa9c9e6ddc261538b8140
|
|
| BLAKE2b-256 |
07bc2e087d73caefe63f91aa5894e6e2ec082b14fff5427e9b6f33e07d3150c5
|