Download IDE_CONFIG_GUIDE.md from polyHedra/PolyHedra: direct link, hf CLI and curl.
- Browser
- Download file 3.33 kB
-
https://huggingface.co/spaces/polyHedra/PolyHedra/resolve/main/IDE_CONFIG_GUIDE.md
- Command line
-
hf download hf://spaces/polyHedra/PolyHedra/IDE_CONFIG_GUIDE.md
-
curl -L -o IDE_CONFIG_GUIDE.md https://huggingface.co/spaces/polyHedra/PolyHedra/resolve/main/IDE_CONFIG_GUIDE.md
Polyhedra IDE Configuration Guide
What is MCP?
MCP (Model Context Protocol) is a protocol that allows AI assistants to call external tools.
You β VS Code Copilot β Polyhedra MCP Server β Semantic Scholar API
(chat) (call tools) (search papers)
Configuration File Location
The configuration file is in your project's .vscode/settings.json:
{
"mcp.servers": {
"polyhedra": {
"command": "py", // β Python launcher
"args": ["-3.12", "-m", "polyhedra.server"], // β Run Polyhedra
"env": {}
}
}
}
What does this configuration do?
- Tells VS Code: "There's an MCP server called polyhedra"
- Launch command: Run
py -3.12 -m polyhedra.server - VS Code auto-starts: When you open Copilot, it starts Polyhedra in the background
How to Verify Configuration?
Method 1: Reload VS Code Window
- Press
Ctrl + Shift + P - Type "Reload Window"
- Press Enter
Method 2: Check MCP Connection (if supported)
Some IDEs show MCP server status in settings.
Usage Examples
After successful configuration, you can say in Copilot Chat:
π Example Conversation:
You: "Search for papers about transformers"
Copilot (internally):
- Recognizes you want to search papers
- Calls Polyhedra's
search_paperstool - Passes parameters: query="transformer"
- Gets results and shows them to you
What you see:
Found 10 papers:
1. Attention is All You Need
Authors: Vaswani et al.
Year: 2017
Citations: 95,432
...
π More Examples:
"Initialize a new research project called ai-research"
β Calls init_project tool
"Add this paper to my bibliography"
β Calls add_citation tool
"Find similar papers about attention mechanisms"
β Calls query_similar_papers tool
Other IDE Configurations
Cursor / Windsurf
Configuration file: ~/.cursor/mcp.json or ~/.windsurf/mcp.json
{
"mcpServers": {
"polyhedra": {
"command": "py",
"args": ["-3.12", "-m", "polyhedra.server"]
}
}
}
Common Issues
Q: I configured it but it's not working?
A: Check:
- Did you reload the VS Code window?
- Is polyhedra installed in Python 3.12? (
py -3.12 -m pip show polyhedra) - Does your GitHub Copilot version support MCP?
Q: How to test if the MCP server can run?
A: Run in terminal:
py -3.12 -m polyhedra.server
If there's no error, the server can start.
Q: Does GitHub Copilot support MCP?
A: GitHub Copilot's MCP support may still be experimental. Alternative: Use Cursor or Windsurf (native MCP support)
Manual Testing (without IDE)
If MCP integration doesn't work, you can run scripts directly:
py -3.12 demo_search.py
This directly calls Polyhedra's functionality to search papers.
Summary
Configuration file (.vscode/settings.json)
β
VS Code reads config on startup
β
Starts Polyhedra MCP Server in background (py -3.12 -m polyhedra.server)
β
Copilot can call Polyhedra's 10 tools
β
You use these tools through natural language conversation
Key Point: The configuration file just tells the IDE how to start Polyhedra. The actual functionality is accessed through conversation.