mcp-server
About
A Model Context Protocol (MCP) server that integrates jina.ai tools (search, web page reading) and serves as a learning project for writing MCP servers. It is designed for use with AI assistants like Claude.
Details
- License
- Apache-2.0
Explore
- Integrates jina.ai tools for search and web page reading.
- Requires Python 3.12 or newer and the uv package manager.
- Configurable via standard MCP JSON settings.
- Supports manual and Smithery-based automatic installation.
- Environment variables for API key management.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
mcp-serverCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
To install mcp-server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @yiGmMk/mcp-server --client claude
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp-server": {
"mcp-server-yigmmk": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@yiGmMk/mcp-server",
"--client",
"claude"
]
}
}
}
}McpServers
{
"mcp-server-yigmmk": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@yiGmMk/mcp-server",
"--client",
"claude"
]
}
}学习写 mcp server
安装 (cline)
Installing via Smithery
To install mcp-server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @yiGmMk/mcp-server --client claude
前置依赖
• Python 3.12 or newer
• uv package manager
没有安装uv的,请参考文档uv 安装文档
macos或linux可使用如下命令安装
curl -LsSf https://astral.sh/uv/install.sh | sh
windwos,在powershell下安装
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
配置文件
优先使用下面这种配置方式
{
"mcpServers": {
"yiGmMk/mcp-server": {
"command": "uv",
"args": [
"--directory",
"/path/to/your/mcp-server",
"run",
"main.py"
],
"env": {
"JINA_API_KEY": "jina_api_key,请从https://jina.ai/reader获取",
"GOOGLE_AI_STUDIO_KEY": "Google AI Studio api key,请从https://aistudio.google.com/apikey获取",
"PYTHONIOENCODING": "utf-8"
},
"disabled": false,
"autoApprove": []
}
}
}
或使用venv(增加环境变量配置)
{
"mcpServers": {
"yiGmMk/mcp-server": {
"command": "uv",
"args": [
"run",
"/path/to/your/mcp-server/main.py"
],
"env": {
"VIRTUAL_ENV": "/path/to/your/mcp-server/.venv",
"JINA_API_KEY": "jina_api_key,请从https://jina.ai/reader获取",
"GOOGLE_AI_STUDIO_KEY": "Google AI Studio api key,请从https://aistudio.google.com/apikey获取",
"PYTHONIOENCODING": "utf-8"
},
"disabled": false,
"autoApprove": []
}
}
}
jina.ai
jina.ai提供的各种工具,如搜索,读取网页...
TODO
- [ ] 发布到 https://smithery.ai/server/@yiGmMk/mcp-server/tools
dockerfile构建成功,但是mcp服务在docker中运行后立即退出,导致无法使用,相关issue:
1.MCP within a Docker Container exits, regardless of lifespan
2. ifespan shuts as soon as it opens
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
