Demo
Requirements
- Python 3.11 or higher
- Dependencies as listed in
pyproject.toml, including:- mcp
- mercari
- pydantic
Pre-setup
-
Microsoft C++ Build Tools (For Windows) https://visualstudio.microsoft.com/visual-cpp-build-tools/
Setup
-
Clone this repository:
git clone https://github.com/msr2903/mercari-jp-mcp.git cd mercari-jp-mcp
-
Create and activate a virtual environment and install dependencies:
uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate uv pip install -e .
Usage
Development Mode
You can test the server with MCP Inspector by running:
uv run server.py
You can also test to input manually the query, exclude keywords, min and max price by running:
uv run check_server.py
This will start the server and allow you to test the available tools.
Integration with Claude for Desktop
To integrate this server with Claude for Desktop:
-
Install Claude for Desktop to your local machine.
-
Install VS Code to your local machine. Then run the following command to open the
claude_desktop_config.jsonfile:- MacOS:
code ~/Library/Application\ Support/Claude/claude_desktop_config.json - Windows:
code $env:AppData\Claude\claude_desktop_config.json
- MacOS:
-
Edit the Claude for Desktop config file, located at:
-
macOS:
{ "mcpServers": { "mercari": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mercari-jp-mcp", "run", "server.py" ] } } }
-
Windows:
{ "mcpServers": { "mercari": { "command": "uv", "args": [ "--directory", "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\mercari-jp-mcp", "run", "server.py" ] } } }
-
Note: You may need to put the full path to the uv executable in the command field. You can get this by running
which uvon MacOS/Linux orwhere uvon Windows.
-
-
Restart Claude for Desktop
Thanks
This work would not have been possible without amazing open source projects, including (but not limited to):
- jlowin/fastmcp (https://github.com/jlowin/fastmcp)
- marvinody/mercari (https://github.com/marvinody/mercari/)
Thank you to the authors of these projects for making them available to the community!
Metadata
Release files for iflow-mcp_msr2903-mercari-mcp 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_msr2903_mercari_mcp-0.1.2.tar.gz | 6.5 kB | Without provenance | Details for iflow_mcp_msr2903_mercari_mcp-0.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_msr2903_mercari_mcp-0.1.2-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_msr2903_mercari_mcp-0.1.2-py3-none-any.whl |
Total release size: 14.0 kB
Release files / iflow_mcp_msr2903_mercari_mcp-0.1.2.tar.gz
| Download URL | iflow_mcp_msr2903_mercari_mcp-0.1.2.tar.gz |
|---|---|
| Size | 6.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1cd7093578e2c4d074e34d2e3c6c2b328396440ad68b4058feff2f27d8366d4f
|
|
BLAKE2b-256 checksum How to use checksums |
4f5ee29afb2d6996c622eefe094db33d3a4b460bf5e4c010ee27c407b5d64d52
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_msr2903_mercari_mcp-0.1.2-py3-none-any.whl
| Download URL | iflow_mcp_msr2903_mercari_mcp-0.1.2-py3-none-any.whl |
|---|---|
| Size | 7.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f4ec7cd5027a642c249b8ddeffd3016b13eb9508ec7e31f335a1c1e4e006bfaa
|
|
BLAKE2b-256 checksum How to use checksums |
4be7465945147ac3c30761f32c7b2a0686292ac660d8807071fd53c08bc8b036
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_msr2903-mercari-mcp 0.1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.